Django4.1 新特点
2022 年 8 月 3 日
欢迎来到 Django 4.1！
这些发行说明涵盖了新功能，以及从 Django 4.0 或更早版本升级时需要注意的一些向后不兼容的更改。我们已经 开始了一些功能的弃用过程。
如果您要更新现有项目，请参阅如何将 Django 升级到更新版本指南。
Python 兼容性¶
Django 4.1 支持 Python 3.8、3.9 和 3.10。我们强烈推荐并且仅官方支持每个系列的最新版本。
视图子类现在可以定义异步 HTTP 方法处理程序：
import asyncio
from django.http import HttpResponse
from django.views import View
class AsyncView(View):
async def get(self, request, *args, **kwargs):
# Perform view logic using await.
await asyncio.sleep(1)
return HttpResponse("Hello async world!")
QuerySet现在为所有数据访问操作提供了一个异步接口。它们按照现有的同步操作命名，但带有a前缀，例如acreate()、aget()等。
新接口允许您编写异步代码，而无需将 ORM 操作包装在sync_to_async()：
async for author in Author.objects.filter(name__startswith="A"):
book = await author.books.afirst()
请注意，在这个阶段，底层数据库操作保持同步，并且正在将异步支持下推到 SQL 编译器中，并集成异步数据库驱动程序。新的异步查询集接口目前 sync_to_async()为您封装了必要的操作，并将允许您的代码随着 ORM 的发展利用异步支持的发展。
为了帮助用户使用屏幕阅读器和其他辅助技术， 推荐使用新模板，它将成为从 Django 5.0 输出表单（如在模板中）时的默认表单呈现样式。 为了便于采用新的输出样式，默认表单和表单集模板现在可以通过 FORM_RENDERER设置在项目级别进行配置。 数据库后端¶ Forms¶ 用于在转换为字符串时呈现表单的默认模板，例如在模板中，现在可以通过设置为 提供的类在项目级别进行配置。 Form.template_name现在是延迟到渲染器的属性，但可以用字符串值覆盖以指定每个表单类的模板名称。 类似地，用于渲染表单集的默认模板可以通过匹配的 formset_template_name渲染器属性来指定。 新的 建议使用这种新的输出样式而不是现有的 as_table(),as_p()和as_ul()样式，因为模板实现 基于 div 的输出将成为 Django 5.0 的默认渲染样式。 为了顺利采用新的 例如： 一旦 如果新的 例如，对于 使用的 新的允许通过新的参数 legend_tag()在标签中呈现字段标签。 和 允许阻止新对象创建的新 Media的 新的BoundField.use_fieldset和Widget.use_fieldset 属性有助于识别其输入应分组在 a error_messages参数 现在允许通过传递 和键BaseFormSet为无效数量的表单自定义错误消息。 IntegerField, FloatField, DecimalField现在可以选择接受一个 Internationalization¶ 管理命令¶ Migrations¶ Models¶ 请求和响应¶ Security¶ Signals¶ Templates¶{{ form }}次要功能¶
FieldListFilter 现在可以在使用查找过滤多个值时控制查询字符串值分隔符__in。clone参数GEOSGeometry.normalize()允许创建几何的标准化克隆。int的按位。XORdefault_bounds属性允许为列表和元组输入指定边界。DateTimeRangeFieldDecimalRangeFieldDatabaseFeatures.minimum_database_version 元组属性（例如，表示“10.0”）指定数据库的最低要求版本。如果指定了最低版本，后端还必须实现 ，它返回当前数据库版本的元组。必须调用后端的 方法才能运行检查。(10, 0)DatabaseWrapper.get_database_version()DatabaseWrapper.init_connection_state()super(){{ form }}form_template_nameFORM_RENDERERdiv.html表单模板、引用 Form.template_name_div属性和匹配Form.as_div() 方法使用 HTML和对相关输入进行分组，并且屏幕阅读器用户更容易导航。FORM_RENDERER = "django.forms.renderers.DjangoDivFormRenderer"
FORM_RENDERER那时可以删除该 声明。 输出样式as_p()，您可以将表单渲染器设置定义form_template_name为 "django/forms/p.html"和formset_template_nameto "django/forms/formsets/p.html"。taglabel_tag()edit_only参数。modelformset_factory()inlineformset_factory()js和cssclass 属性 现在允许使用可散列对象，而不仅仅是路径字符串，只要这些对象实现该方法（通常在使用装饰器装饰时）。__html__()html_safe()和 a中的小部件。'too_few_forms''too_many_forms'step_size 参数。这用于设置stepHTML 属性，并在表单提交时进行验证。stderrstdoutdjango_migrationsblack命令进行格式化，如果它存在于您的PATH.RemoveIndex重AddIndex命名 Meta.indexes.AlterIndexTogether的AddIndex索引 移动 Meta.index_together到 Meta.indexes.order_by参数 Window现在接受对字段和转换的字符串引用。chunk_size提供参数就支持预取相关对象。在旧版本中，没有进行预取。^互斥或 ( XOR) 运算符进行组合。XORMariaDB 和 MySQL 原生支持。对于不支持的数据库，将使用、和XOR将查询转换为等效的。ANDORNOTAutoField和BigAutoField现在SmallAutoField被创建为标识列，而不是带有序列的串行列。max_age。origin删除。