管理中的方面过滤器¶

现在，当通过 UI 切换时，会在管理更改列表中显示已应用过滤器的构面计数。可以通过新属性更改此行为 ModelAdmin.show_facets。有关详细信息，请参阅 构面。

表单字段渲染的简化模板¶

Django 5.0 引入了字段组和字段组模板的概念。这简化了 Django 表单字段相关元素的呈现，例如标签、小部件、帮助文本和错误。

例如下面的模板：

<form>
...
<div>{{ form.name.label_tag }}{% if form.name.help_text %}<div class="helptext" id="{{ form.name.auto_id }}_helptext">{{ form.name.help_text|safe }}</div>{% endif %}{{ form.name.errors }}{{ form.name }}<div class="row"><div class="col">{{ form.email.label_tag }}{% if form.email.help_text %}<div class="helptext" id="{{ form.email.auto_id }}_helptext">{{ form.email.help_text|safe }}</div>{% endif %}{{ form.email.errors }}{{ form.email }}</div><div class="col">{{ form.password.label_tag }}{% if form.password.help_text %}<div class="helptext" id="{{ form.password.auto_id }}_helptext">{{ form.password.help_text|safe }}</div>{% endif %}{{ form.password.errors }}{{ form.password }}</div></div>
</div>
...
</form>

现在可以简化为：

<form>
...
<div>{{ form.name.as_field_group }}<div class="row"><div class="col">{{ form.email.as_field_group }}</div><div class="col">{{ form.password.as_field_group }}</div></div>
</div>
...
</form>

as_field_group()默认情况下使用模板呈现字段 "django/forms/field.html"，并且可以根据每个项目、每个字段或每个请求进行自定义。请参阅 可重复使用的字段组模板。

数据库生成的模型字段¶

新功能GeneratedField允许创建数据库生成的列。该字段可在所有支持的数据库后端上使用，以创建始终根据其他字段计算的字段。例如：

from django.db import models
from django.db.models import Fclass Square(models.Model):side = models.IntegerField()area = models.GeneratedField(expression=F("side") * F("side"),output_field=models.BigIntegerField(),db_persist=True,)

用于声明字段选择的更多选项¶

Field.choices （对于模型字段）和（对于表单字段）在声明其值时允许更大的灵活性。在 Django 的早期版本中，应该是二元组列表，或者是枚举类型子类，但后者需要访问属性以提供预期形式的值：ChoiceField.choices choices.choices

from django.db import modelsMedal = models.TextChoices("Medal", "GOLD SILVER BRONZE")SPORT_CHOICES = [("Martial Arts", [("judo", "Judo"), ("karate", "Karate")]),("Racket", [("badminton", "Badminton"), ("tennis", "Tennis")]),("unknown", "Unknown"),
]class Winner(models.Model):name = models.CharField(...)medal = models.CharField(..., choices=Medal.choices)sport = models.CharField(..., choices=SPORT_CHOICES)

Django 5.0 添加了对接受映射或可调用而不是可迭代的支持，并且不再需要.choices直接用于扩展枚举类型：

在幕后，每当更新值时，所提供的choices都会被标准化为 2 元组列表作为规范形式。choices有关更多信息，请检查选项上的模型字段参考。

小功能¶

数据库后端API ¶

本节描述第三方数据库后端可能需要的更改。

• DatabaseFeatures.supports_expression_defaultsFalse 如果数据库不支持使用数据库函数作为默认值，则应设置为。
• DatabaseFeatures.supports_default_keyword_in_insertFalse如果数据库不支持查询DEFAULT中的关键字 ，则应设置为 INSERT。
• DatabaseFeatures.supports_default_keyword_in_bulk_insertFalse如果数据库不支持DEFAULT批量查询中的关键字 ，则应设置为 INSERT。

django.contrib.gis¶

• 删除了对 GDAL 2.2 和 2.3 的支持。
• 删除了对 GEOS 3.6 和 3.7 的支持。

django.contrib.sitemaps¶

• 由于 Google Sitemaps ping 端点已弃用，该django.contrib.sitemaps.ping_google()功能和 ping_google管理命令已被删除，并将于 2024 年 1 月删除。
• 异常django.contrib.sitemaps.SitemapNotFound类被删除。

放弃对 MySQL < 8.0.11 的支持¶

删除了对 MySQL 8.0.x 系列预发行版的支持。Django 5.0 支持 MySQL 8.0.11 及更高版本。

create_defaults__exact现在可能需要使用QuerySet.update_or_create()¶

QuerySet.update_or_create()现在支持参数 create_defaults. 因此，任何具有 create_defaults与 一起使用的名为 的字段的模型update_or_create()都应该在查找中使用 指定该字段create_defaults__exact。

迁移UUIDFieldMariaDB 10.7+ 上的现有版本¶

在 MariaDB 10.7+ 上，UUIDField现在创建为UUID列而不是 CHAR(32)列。因此，UUIDField在 Django < 5.0 中创建的任何内容都应该替换为以下UUIDField子类 CHAR(32)：

class Char32UUIDField(models.UUIDField):def db_type(self, connection):return "char(32)"

例如：

class MyModel(models.Model):uuid = models.UUIDField(primary_key=True, default=uuid.uuid4)

应该变成：

class Char32UUIDField(models.UUIDField):def db_type(self, connection):return "char(32)"class MyModel(models.Model):uuid = Char32UUIDField(primary_key=True, default=uuid.uuid4)

运行该makemigrations命令将生成包含无操作操作的迁移AlterField。

各种各样的¶

• instance未记录方法的参数 被BaseModelFormSet.save_existing()重命名为obj。
• 无证的django.contrib.admin.helpers.checkbox被删除。
• 整数字段现在在 SQLite 上验证为 64 位整数，以匹配sqlite3.
• 未记录的Query.annotation_select_mask属性从一组字符串更改为有序的字符串列表。
• ImageField.update_dimension_fields()post_init如果width_field和height_field未设置，则不再在信号上调用 。
• Now现在使用数据库功能 LOCALTIMESTAMP而不是CURRENT_TIMESTAMPOracle 上的功能。
• AdminSite.site_header现在在标签中呈现，<div>而不是在 <h1>. 屏幕阅读器用户依靠标题元素在页面内进行导航。有两个<h1>元素很令人困惑，而且站点标题没有帮助，因为它在所有页面上重复。
• 为了提高可访问性，管理员的主要内容区域和标题内容区域现在呈现在 a<main>和<header>标记中，而不是 <div>。
• 在不支持 SQLXOR运算符的数据库上，^异或 ( XOR) 运算符现在返回与奇数个操作数匹配的行，而不是仅与一个操作数匹配。这与 MySQL、MariaDB 和 Python 的行为一致。
• 最低支持版本asgiref从 3.6.0 增加到 3.7.0。
• 最低支持版本selenium从 3.8.0 增加到 4.8.0。
• 和例外AlreadyRegistered情况NotRegistered从 django.contrib.admin.sites移至django.contrib.admin.exceptions。
• SQLite 的最低支持版本从 3.21.0 增加到 3.27.0。
• cx_Oracle删除了对 <8.3 的支持。
• 现在，在应用程序注册表完全填充之前执行 SQL 查询会引发RuntimeWarning.
• BadRequest针对具有application/x-www-form-urlencoded内容类型的非 UTF-8 编码请求引发。看RFC 1866了解更多详细信息。
• 最低支持版本colorama增加至0.4.6。
• 最低支持版本docutils增加至0.19。

各种各样的¶

• 和过渡形式DjangoDivFormRenderer渲染Jinja2DivFormRenderer器已被弃用。
• 不推荐使用传递位置参数name和violation_error_messageto BaseConstraint，而是使用仅关键字参数。
• request添加到 的签名中ModelAdmin.lookup_allowed()。不推荐支持ModelAdmin不接受此参数的子类。
• and 方法get_joining_columns()已被弃用。从 Django 6.0 开始， 将不再回退到 . 子类应该 代替实现。ForeignObjectForeignObjectReldjango.db.models.sql.datastructures.Joinget_joining_columns()get_joining_fields()
• 该ForeignObject.get_reverse_joining_columns()方法已被弃用。
• 在 Django 6.0 中，默认方案forms.URLField将从 更改"http"为 "https"。将FORMS_URLFIELD_ASSUME_HTTPS 过渡设置设置为True选择"https"在 Django 5.x 发布周期期间进行假设。
• FORMS_URLFIELD_ASSUME_HTTPS过渡设置已被弃用。
• 对不传递 args 或 kwargs 的调用的支持format_html()将被删除。
• cx_Oracle不推荐使用对oracledb 1.3.2+ Python 驱动程序的支持。
• DatabaseOperations.field_cast_sql()已被弃用，取而代之的是 DatabaseOperations.lookup_cast(). 从 Django 6.0 开始， BuiltinLookup.process_lhs()将不再调用field_cast_sql(). 第三方数据库后端应该改为实施lookup_cast()。
• 元django.db.models.enums.ChoicesMeta类被重命名为 ChoicesType.
• 该Prefetch.get_current_queryset()方法已被弃用。
• 相关管理器和描述符的方法get_prefetch_queryset()已被弃用。从 Django 6.0 开始，get_prefetcher()将 prefetch_related_objects()不再回退到 get_prefetch_queryset(). 子类应该 get_prefetch_querysets()代替实现。