--- title: "Django 1.6 版本发行说明" version: 5.1 locale: zh-hans source: https://docs.djangoproject.com/zh-hans/5.1/releases/1.6/ canonical: https://djangodocs.dev/zh-hans/5.1/releases/1.6/ --- # Django 1.6 版本发行说明 > **Note** > > 献给 Malcolm Tredinnick > > 在 2013 年 3 月 17 日，Django 项目和自由软件社区失去了一位非常亲爱的朋友和开发者。 > > Malcolm 是 Django 的长期贡献者，模范社区成员，一位聪明的人，也是我们的朋友。他对 Django 和其他许多开源项目的贡献几乎无法计数。 Django 核心团队中的许多人都是通过他审查第一批补丁，他的指导使我们受益匪浅。他的关心、耐心和奉献精神将永远激励着我们。 > > 这个 Django 版本是为了纪念 Malcolm 而发布的。 > > -- Django 开发者们 *2013 年 11 月 6 日* 欢迎使用 Django 1.6 ！ 这些发布说明涵盖了 [新功能](#whats-new-1-6)，以及从 Django 1.5 或更早版本升级时需要注意的一些 [向后不兼容的更改](#backwards-incompatible-1-6)。我们还删除了一些功能，详细信息在 [我们的弃用计划](/zh-hans/5.1/internals/deprecation/#deprecation-removed-in-1-6) 中说明，同时我们已经 [开始了一些功能的弃用过程](#deprecated-features-1-6)。 ## Python 兼容性 与 Django 1.5 一样，Django 1.6 需要 Python 2.6.5 或更高版本。Python 3 也得到官方支持。我们 **强烈推荐** 使用每个支持的 Python 系列的最新次要版本（2.6.X、2.7.X、3.2.X 和 3.3.X）。 Django 1.6 将是最后一个支持 Python 2.6 的发布系列；从 Django 1.7 开始，最低支持的 Python 版本将是 2.7 。 Python 3.4 目前不被支持，但将在 Django 1.7 中添加支持。 ## Django 1.6 的新功能有哪些？ ### 简化了默认的项目和应用模板 [`startproject`](/zh-hans/5.1/ref/django-admin/#django-admin-startproject) 和 [`startapp`](/zh-hans/5.1/ref/django-admin/#django-admin-startapp) 使用的默认模板已经简化和现代化。新项目默认启用 [admin](/zh-hans/5.1/ref/contrib/admin/)，不再使用 [sites](/zh-hans/5.1/ref/contrib/sites/) 框架。[防止点击劫持](/zh-hans/5.1/ref/clickjacking/#clickjacking-prevention) 现在默认开启，数据库默认为 SQLite。 如果默认模板不符合您的喜好，您可以使用 [自定义项目和应用程序模板](/zh-hans/5.1/ref/django-admin/#custom-app-and-project-templates)。 ### 改进了事务管理 Django 的事务管理经过了彻底改进。现在默认情况下已经打开了数据库级别的自动提交。这使得事务处理更加明确，并应该提高性能。现有的 API 已被弃用，并引入了新的 API，详情请参阅 [事务管理文档](/zh-hans/5.1/topics/db/transactions/)。 ### 引入了持久性数据库连接 Django 现在支持在多个请求中重复使用同一个数据库连接。这可以避免在每个请求开始时重新建立连接的开销。出于向后兼容性考虑，此功能默认是禁用的。请查看 [持久连接](/zh-hans/5.1/ref/databases/#persistent-database-connections) 以获取详细信息。 ### 能够发现任何测试模块中的测试 Django 1.6 提供了一个新的测试运行器，允许更灵活地定位测试。之前的运行器（`django.test.simple.DjangoTestSuiteRunner`）只在 [`INSTALLED_APPS`](/zh-hans/5.1/ref/settings/#std-setting-INSTALLED_APPS) 中的 Python 包的 `models.py` 和 `tests.py` 模块中找到测试。 新的运行器（`django.test.runner.DiscoverRunner`）使用了内置于 `unittest2` 中的测试发现功能（Python 2.7+ 标准库中的 `unittest` 版本，与 Django 捆绑在一起）。使用测试发现，测试可以位于任何模块中，其名称匹配模式 `test*.py`。 此外，提供给 `./manage.py test` 的测试标签，用于指定要运行的特定测试，现在必须是完整的 Python 点路径（或目录路径），而不是伪路径 `applabel.TestCase.test_method_name`。这允许运行位于代码库中任何位置的测试，而不仅仅是 [`INSTALLED_APPS`](/zh-hans/5.1/ref/settings/#std-setting-INSTALLED_APPS) 中的测试。有关更多详细信息，请参阅 [Django 中的测试](/zh-hans/5.1/topics/testing/)。 这个改变是向后不兼容的，请参阅 [向后不兼容的说明](#new-test-runner)。 ### 时区感知的聚合 Django 1.4 中引入的对 [时区](/zh-hans/5.1/topics/i18n/timezones/) 的支持在 [`QuerySet.dates()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.dates) 上并不完善：聚合总是在 UTC 中执行。在 Django 1.6 中解除了这个限制。使用 [`QuerySet.datetimes()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.datetimes) 来对 [`DateTimeField`](/zh-hans/5.1/ref/models/fields/#django.db.models.DateTimeField) 进行时区感知的聚合。 ### 在 SQLite 中支持保存点（savepoints） Django 1.6 在 SQLite 中添加了对保存点的支持，但存在一些 [限制](/zh-hans/5.1/topics/db/transactions/#savepoints-in-sqlite)。 ### `BinaryField` 模型字段 新的 [`django.db.models.BinaryField`](/zh-hans/5.1/ref/models/fields/#django.db.models.BinaryField) 模型字段允许在数据库中存储原始二进制数据。 ### GeoDjango 表单小部件 GeoDjango 现在为其地理专用字段提供了 [表单字段和小部件](/zh-hans/5.1/ref/contrib/gis/forms-api/)。它们默认使用 OpenLayers，但可以自定义为使用任何其他 JavaScript 框架。 ### 新增了 `check` 管理命令，用于验证兼容性。 新增了 [`check`](/zh-hans/5.1/ref/django-admin/#django-admin-check) 管理命令，可以用来验证您当前的配置（目前是基于设置）是否与当前版本的 Django 兼容。 ### [`Model.save()`](/zh-hans/5.1/ref/models/instances/#django.db.models.Model.save) 算法已更改 [`Model.save()`](/zh-hans/5.1/ref/models/instances/#django.db.models.Model.save) 方法现在会尝试直接执行数据库 `UPDATE` 操作，如果实例具有主键值。以前会执行 `SELECT` 来确定是否需要执行 `UPDATE` 或 `INSERT`。新算法只需要一次查询来更新现有行，而旧算法需要两次。有关更多详细信息，请参阅 [`Model.save()`](/zh-hans/5.1/ref/models/instances/#django.db.models.Model.save)。 在一些罕见的情况下，数据库在执行 `UPDATE` 时可能不会报告找到匹配的行。一个例子是 PostgreSQL 中的 `ON UPDATE` 触发器，它返回 `NULL`。在这种情况下，可以设置 [`django.db.models.Options.select_on_save`](/zh-hans/5.1/ref/models/options/#django.db.models.Options.select_on_save) 标志来强制使用旧算法进行保存。 ### 次要特性 - 身份验证后端可以引发 `PermissionDenied` 来立即终止身份验证链。 - 可以使用 [`CSRF_COOKIE_HTTPONLY`](/zh-hans/5.1/ref/settings/#std-setting-CSRF_COOKIE_HTTPONLY) 来在 CSRF Cookie 上设置 `HttpOnly` 标志。 - `assertQuerysetEqual()` 现在检查未定义的排序，并在发现未定义的排序时引发 [`ValueError`](https://docs.python.org/3/library/exceptions.html#ValueError)。如果给定的 `QuerySet` 没有排序，并且有多个排序值要进行比较，那么排序被视为未定义。 - 新增了 [`earliest()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.earliest)，以与 [`latest()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.latest) 对称。 - 除了 [`year`](/zh-hans/5.1/ref/models/querysets/#std-fieldlookup-year)、[`month`](/zh-hans/5.1/ref/models/querysets/#std-fieldlookup-month) 和 [`day`](/zh-hans/5.1/ref/models/querysets/#std-fieldlookup-day)，ORM 现在还支持 [`hour`](/zh-hans/5.1/ref/models/querysets/#std-fieldlookup-hour)、[`minute`](/zh-hans/5.1/ref/models/querysets/#std-fieldlookup-minute) 和 [`second`](/zh-hans/5.1/ref/models/querysets/#std-fieldlookup-second) 查找。 - Django 现在包装了所有 [**PEP 249**](https://peps.python.org/pep-0249/) 异常。 - [`EmailField`](/zh-hans/5.1/ref/forms/fields/#django.forms.EmailField)、[`URLField`](/zh-hans/5.1/ref/forms/fields/#django.forms.URLField)、[`IntegerField`](/zh-hans/5.1/ref/forms/fields/#django.forms.IntegerField)、[`FloatField`](/zh-hans/5.1/ref/forms/fields/#django.forms.FloatField) 和 [`DecimalField`](/zh-hans/5.1/ref/forms/fields/#django.forms.DecimalField) 的默认小部件现在使用 HTML5 中可用的新类型属性（`type='email'`、`type='url'`、`type='number'`）。请注意，由于当前浏览器中对本地化数字支持不稳定，因此 Django 只在数值字段未本地化时使用 `number` 输入类型。 - 对于 [延迟复数翻译](/zh-hans/5.1/topics/i18n/translation/#lazy-plural-translations)，可以在翻译时提供 `number` 参数，而不是在定义时提供。 - 对于自定义管理命令：在要求使用 `BaseCommand.can_import_settings` 内部选项的命令中，现在独立于处理执行命令期间应处于活动状态的区域设置的验证。后者现在可以受到新的 `BaseCommand.leave_locale_alone` 内部选项的影响。有关更多详细信息，请参阅 管理命令和区域设置。 - [`DeletionMixin`](/zh-hans/5.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.DeletionMixin) 的 [`success_url`](/zh-hans/5.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.DeletionMixin.success_url) 现在使用其 `object` 的 `__dict__` 进行插值。 - [`HttpResponseRedirect`](/zh-hans/5.1/ref/request-response/#django.http.HttpResponseRedirect) 和 [`HttpResponsePermanentRedirect`](/zh-hans/5.1/ref/request-response/#django.http.HttpResponsePermanentRedirect) 现在提供了一个 `url` 属性（等同于响应将重定向到的 URL）。 - `MemcachedCache` 缓存后端现在使用了最新可用的 [`pickle`](https://docs.python.org/3/library/pickle.html#module-pickle) 协议。 - 新增了 [`SuccessMessageMixin`](/zh-hans/5.1/ref/contrib/messages/#django.contrib.messages.views.SuccessMessageMixin)，它为基于 [`FormView`](/zh-hans/5.1/ref/class-based-views/generic-editing/#django.views.generic.edit.FormView) 的类提供了一个 `success_message` 属性。 - 新增了 [`django.db.models.ForeignKey.db_constraint`](/zh-hans/5.1/ref/models/fields/#django.db.models.ForeignKey.db_constraint) 和 [`django.db.models.ManyToManyField.db_constraint`](/zh-hans/5.1/ref/models/fields/#django.db.models.ManyToManyField.db_constraint) 选项。 - jQuery 库嵌入在管理系统中已升级至 1.9.1 版本。 - 现在，通过新的 [`Feed.get_context_data()`](/zh-hans/5.1/ref/contrib/syndication/#django.contrib.syndication.Feed.get_context_data) 回调，订阅源（[`django.contrib.syndication`](/zh-hans/5.1/ref/contrib/syndication/#module-django.contrib.syndication)）可以将额外的上下文传递给订阅源模板。 - 在 HTML 中，管理员列表列具有 `column-` 类，因此可以使用 CSS 对列标题进行样式设置，例如设置列宽。 - 在 PostgreSQL 下，可以自定义 [隔离级别](/zh-hans/5.1/ref/databases/#database-isolation-level)。 - [`blocktrans`](/zh-hans/5.1/topics/i18n/translation/#std-templatetag-blocktrans) 模板标签现在像其他模板结构一样，尊重对于上下文中不存在的变量的 `TEMPLATE_STRING_IF_INVALID`。 - 在 shell 调试情况下，`SimpleLazyObject` 现在会提供更有帮助的表示。 - 通用的 [`GeometryField`](/zh-hans/5.1/ref/contrib/gis/model-api/#django.contrib.gis.db.models.GeometryField) 现在可以在管理员中使用 OpenLayers 小部件进行编辑。 - 文档中包含一个 [部署清单](/zh-hans/5.1/howto/deployment/checklist/)。 - [`diffsettings`](/zh-hans/5.1/ref/django-admin/#django-admin-diffsettings) 命令增加了 `--all` 选项。 - `django.forms.fields.Field.__init__` 现在调用了 `super()`，允许字段混合类实现 `__init__()` 方法，并可靠地被调用。 - 在 `BaseFormSet` 和 [`formset_factory()`](/zh-hans/5.1/ref/forms/formsets/#django.forms.formsets.formset_factory) 以及 `ModelForm` 和相应的内联版本中添加了 `validate_max` 参数。对于带有 `max_num` 的表单集的验证行为进行了澄清。之前未记录的行为，以防止内存耗尽攻击的表单集被记录下来，同时未记录的高于 1000 或 `max_num` 的上限已更改，现在它总是比 `max_num` 多 1000。 - 添加了 `BCryptSHA256PasswordHasher` 来解决 bcrypt 密码截断问题。 - [Pillow](https://pypi.org/project/Pillow/) 现在是与 Django 一起使用的首选图像处理库。 [PIL](https://pypi.org/project/PIL/) 已经进入弃用过程（在 Django 1.8 中将删除支持）。要升级，您应该 **首先** 卸载 PIL，**然后** 安装 Pillow。 - [`ModelForm`](/zh-hans/5.1/topics/forms/modelforms/#django.forms.ModelForm) 接受了一些新的 `Meta` 选项。 - 包含在 `localized_fields` 列表中的字段将会本地化（通过在表单字段上设置 `localize`）。 - `labels`、`help_texts` 和 `error_messages` 选项可以用来自定义默认字段，请参阅 [覆盖默认字段](/zh-hans/5.1/topics/forms/modelforms/#modelforms-overriding-default-fields) 获取详细信息。 - 模型字段的 `choices` 参数现在接受一个可迭代的可迭代对象，而不是需要一个列表或元组的可迭代对象。 - 可以使用 [`reason_phrase`](/zh-hans/5.1/ref/request-response/#django.http.HttpResponse.reason_phrase) 来自定义 HTTP 响应的原因短语。 - 在为 `django.contrib.auth.views.logout()`、`django.contrib.auth.views.password_reset()`、`django.contrib.auth.views.password_reset_confirm()` 和 `django.contrib.auth.views.password_change()` 提供下一页的 URL 时，现在可以传递 URL 名称，并将其解析。 - 新的 [`dumpdata --pks`](/zh-hans/5.1/ref/django-admin/#cmdoption-dumpdata-pks) 选项指定要转储的对象的主键。此选项只能与一个模型一起使用。 - 新增了 `QuerySet` 方法 [`first()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.first) 和 [`last()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.last)，这些是返回与过滤条件匹配的第一个或最后一个对象的便利方法。如果没有匹配的对象，则返回 `None`。 - [`View`](/zh-hans/5.1/ref/class-based-views/base/#django.views.generic.base.View) 和 [`RedirectView`](/zh-hans/5.1/ref/class-based-views/base/#django.views.generic.base.RedirectView) 现在支持 HTTP `PATCH` 方法。 - `GenericForeignKey` 现在接受一个可选的 `for_concrete_model` 参数，当设置为 `False` 时，允许字段引用代理模型。默认值为 `True`，以保留旧的行为。 - [`LocaleMiddleware`](/zh-hans/5.1/ref/middleware/#django.middleware.locale.LocaleMiddleware) 现在如果活动语言不在会话中，则会将其存储在会话中。这可以防止在会话刷新后（例如注销）丢失语言设置。 - [`SuspiciousOperation`](/zh-hans/5.1/ref/exceptions/#django.core.exceptions.SuspiciousOperation) 被细分为多个子类，并且每个子类都会记录到与 `django.security` 日志层次结构下的匹配命名的记录器中。随着这个变化，每当一个 `SuspiciousOperation` 到达 WSGI 处理程序以返回一个 `HttpResponseBadRequest` 时，将使用 `handler400` 机制和默认视图。 - [`DoesNotExist`](/zh-hans/5.1/ref/models/class/#django.db.models.Model.DoesNotExist) 异常现在包含一个消息，指示用于查找的属性的名称。 - [`get_or_create()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.get_or_create) 方法不再需要至少一个关键字参数。 - [`SimpleTestCase`](/zh-hans/5.1/topics/testing/tools/#django.test.SimpleTestCase) 类包括一个用于测试表单集错误的新断言助手：`django.test.SimpleTestCase.assertFormsetError()`。 - 通过 [`select_related()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.select_related) 添加到 [`QuerySet`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet) 的相关字段列表可以使用 `select_related(None)` 清除。 - [`InlineModelAdmin`](/zh-hans/5.1/ref/contrib/admin/#django.contrib.admin.InlineModelAdmin) 上的 [`get_extra()`](/zh-hans/5.1/ref/contrib/admin/#django.contrib.admin.InlineModelAdmin.get_extra) 和 [`get_max_num()`](/zh-hans/5.1/ref/contrib/admin/#django.contrib.admin.InlineModelAdmin.get_max_num) 方法可以被覆盖，以自定义内联表单的额外和最大数量。 - 现在，表单集具有一个 [`total_error_count()`](/zh-hans/5.1/topics/forms/formsets/#django.forms.formsets.BaseFormSet.total_error_count) 方法。 - [`ModelForm`](/zh-hans/5.1/topics/forms/modelforms/#django.forms.ModelForm) 字段现在可以使用 `Field` 构造函数的 [`error_messages`](/zh-hans/5.1/ref/forms/fields/#django.forms.Field.error_messages) 参数覆盖模型字段中定义的错误消息。要利用这个新特性来自定义字段，请参阅 [更新的建议](/zh-hans/5.1/ref/forms/validation/#raising-validation-error) 来引发 `ValidationError`。 - [`ModelAdmin`](/zh-hans/5.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin) 在创建、编辑或删除对象后，现在会保留列表视图上的过滤器。可以通过将 [`preserve_filters`](/zh-hans/5.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin.preserve_filters) 属性设置为 `False` 来恢复以前的清除过滤器的行为。 - 新增了 [`FormMixin.get_prefix`](/zh-hans/5.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.FormMixin.get_prefix) （默认返回 [`FormMixin.prefix`](/zh-hans/5.1/ref/class-based-views/mixins-editing/#django.views.generic.edit.FormMixin.prefix)），允许自定义表单的 [`prefix`](/zh-hans/5.1/ref/forms/api/#django.forms.Form.prefix)。 - 原始查询（`Manager.raw()` 或 `cursor.execute()`）现在可以使用 "pyformat" 参数样式，其中查询中的占位符以 `'%(name)s'` 形式给出，参数以字典形式传递，而不是列表（在 SQLite 上除外）。在 MySQL 和 PostgreSQL 上早就支持（但未得到官方支持），现在在 Oracle 上也可用。 - PBKDF2 密码哈希器的默认迭代次数增加了 20%。这个向后兼容的更改不会影响现有的密码或已经子类化 `django.contrib.auth.hashers.PBKDF2PasswordHasher` 以更改默认值的用户。必要时，密码将 [被升级](/zh-hans/5.1/topics/auth/passwords/#password-upgrades) 以使用新的迭代次数。 ## Django 1.6 中的向后不兼容变更 > **Warning** > > 除了本节中概述的更改之外，还请务必查看 [弃用计划](/zh-hans/5.1/internals/deprecation/#deprecation-removed-in-1-6)，以了解已删除的功能。如果在给定功能的弃用时间范围内未更新代码，则其删除可能会显示为不向后兼容的更改。 ### 全新的事务管理模型 #### 行为变更 在 Django 1.6 中，默认情况下启用了数据库级别的自动提交。虽然这不会改变 Django 事务管理的一般原则，但会引入一些不兼容性。 #### 保存点和 `assertNumQueries` 事务管理的变更可能会导致额外的语句来创建、释放或回滚保存点。这在 SQLite 中更有可能发生，因为在此版本之前它不支持保存点。 如果使用 [`assertNumQueries()`](/zh-hans/5.1/topics/testing/tools/#django.test.TransactionTestCase.assertNumQueries) 的测试因查询次数超过预期而失败，请检查额外的查询是否与保存点相关，并相应地调整预期的查询次数。 #### PostgreSQL 的自动提交选项 在先前版本中，数据库级别的自动提交仅适用于 PostgreSQL，并且默认情况下被禁用。现在该选项被忽略并可以移除。 ### 全新的测试运行器 为了与 Python 的 `unittest` 模块保持更一致，新的测试运行器（`django.test.runner.DiscoverRunner`）不会自动支持以前的运行器支持的一些测试类型： - 不再会查找和运行 `models.py` 和 `tests/__init__.py` 文件中的测试。将它们移到文件名以 `test` 开头的文件中。 - 不再自动发现 doctests。要将 doctests 集成到测试套件中，请遵循 Python 文档中的 [建议](https://docs.python.org/3/library/doctest.html#doctest-unittest-api)。 Django 包含了 Python 标准库中的 [`doctest`](https://docs.python.org/3/library/doctest.html#module-doctest) 模块的修改版本（在 `django.test._doctest` 中），并包含一些额外的 doctest 工具。这些工具已被弃用，并将在 Django 1.8 中删除；doctest 测试套件应该更新以使用标准库的 doctest 模块（或转换为与 `unittest` 兼容的测试）。 如果希望延迟更新测试套件，可以将 [`TEST_RUNNER`](/zh-hans/5.1/ref/settings/#std-setting-TEST_RUNNER) 设置为 `django.test.simple.DjangoTestSuiteRunner`，以完全恢复旧的测试行为。虽然 `DjangoTestSuiteRunner` 已被弃用，但在 Django 1.8 版本之前不会从 Django 中删除。 ### 移除了 `django.contrib.gis.tests.GeoDjangoTestSuiteRunner` GeoDjango 自定义测试运行器。 这适用于开发 GeoDjango 应用程序本身及其相关开发人员，与上述有关测试运行器变更的项目相关： `django.contrib.gis.tests.GeoDjangoTestSuiteRunner` 测试运行器已被移除，它实现的独立 GeoDjango 测试执行设置不再受支持。要运行 GeoDjango 测试，只需使用新的 `DiscoverRunner` 并指定 `django.contrib.gis` 应用程序。 ### 在测试中使用自定义用户模型 新测试运行器的引入也稍微改变了测试模型的导入方式。因此，任何覆盖 `AUTH_USER_MODEL` 以测试与 Django 的测试用户模型之一（`django.contrib.auth.tests.custom_user.CustomUser` 和 `django.contrib.auth.tests.custom_user.ExtensionUser`）行为的测试现在必须在测试模块中显式导入用户模型： ``` from django.contrib.auth.tests.custom_user import CustomUser @override_settings(AUTH_USER_MODEL="auth.CustomUser") class CustomUserFeatureTests(TestCase): def test_something(self): # Test code here ... ``` 这个导入语句会强制注册自定义用户模型。如果没有这个导入语句，测试将无法切换到自定义用户模型，你将会收到一个错误报告： ```pytb ImproperlyConfigured: AUTH_USER_MODEL refers to model 'auth.CustomUser' that has not been installed ``` ### 时间区域感知的 `day`、`month` 和 `week_day` 查找 Django 1.6 在 [`USE_TZ`](/zh-hans/5.1/ref/settings/#std-setting-USE_TZ) 为 `True` 时引入了对 [`day`](/zh-hans/5.1/ref/models/querysets/#std-fieldlookup-day)、[`month`](/zh-hans/5.1/ref/models/querysets/#std-fieldlookup-month) 和 [`week_day`](/zh-hans/5.1/ref/models/querysets/#std-fieldlookup-week_day) 查找的时间区域支持。以前，这些查找在不考虑当前时区的情况下都在 UTC 中执行。 这需要数据库中的 [时区定义](/zh-hans/5.1/ref/models/querysets/#database-time-zone-definitions)。如果使用的是 SQLite，你必须安装 [pytz](http://pytz.sourceforge.net/)。如果使用的是 MySQL，你必须安装 [pytz](http://pytz.sourceforge.net/) 并使用 [mysql\_tzinfo\_to\_sql](https://dev.mysql.com/doc/refman/en/mysql-tzinfo-to-sql.html) 加载时区表。 ### 添加了 `QuerySet.datetimes()` 方法 当 Django 1.4 中添加的 [时区支持](/zh-hans/5.1/topics/i18n/timezones/) 处于活动状态时，[`QuerySet.dates()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.dates) 查找返回了意外的结果，因为聚合是在 UTC 中执行的。为了解决这个问题，Django 1.6 引入了一个新的 API，[`QuerySet.datetimes()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.datetimes)。这需要在你的代码中进行一些更改。 #### `QuerySet.dates()` 返回的是 `date` 对象 [`QuerySet.dates()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.dates) 现在返回的是 [`date`](https://docs.python.org/3/library/datetime.html#datetime.date) 的列表。它以前返回的是 [`datetime`](https://docs.python.org/3/library/datetime.html#datetime.datetime) 的列表。 [`QuerySet.datetimes()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.datetimes) 返回的是 [`datetime`](https://docs.python.org/3/library/datetime.html#datetime.datetime) 的列表。 #### `QuerySet.dates()` 不再适用于 `DateTimeField` 当时间区域支持处于活动状态时，如果在 [`DateTimeField`](/zh-hans/5.1/ref/models/fields/#django.db.models.DateTimeField) 上使用 [`QuerySet.dates()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.dates) 会引发错误。此时应该使用 [`QuerySet.datetimes()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.datetimes)。 #### `date_hierarchy` 需要时间区域定义 在管理员中使用 [`date_hierarchy`](/zh-hans/5.1/ref/contrib/admin/#django.contrib.admin.ModelAdmin.date_hierarchy) 特性时，如果它用于 [`DateTimeField`](/zh-hans/5.1/ref/models/fields/#django.db.models.DateTimeField)，现在会依赖于 [`QuerySet.datetimes()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.datetimes)。 这需要在数据库中启用时区定义，当 [`USE_TZ`](/zh-hans/5.1/ref/settings/#std-setting-USE_TZ) 设置为 `True` 时。详细信息请参阅 [了解更多](/zh-hans/5.1/ref/models/querysets/#database-time-zone-definitions)。 #### 在通用视图中使用的 `date_list` 需要时间区域的定义 出于相同的原因，当视图基于 [`DateTimeField`](/zh-hans/5.1/ref/models/fields/#django.db.models.DateTimeField) 且 [`USE_TZ`](/zh-hans/5.1/ref/settings/#std-setting-USE_TZ) 设置为 `True` 时，在日期为基础的通用视图中访问上下文中的 `date_list` 需要数据库中的时间区域定义。详细信息请参阅 [了解更多](/zh-hans/5.1/ref/models/querysets/#database-time-zone-definitions)。 ### 新的查找可能与模型字段冲突 Django 1.6 引入了在 [`DateTimeField`](/zh-hans/5.1/ref/models/fields/#django.db.models.DateTimeField) 上的 `hour`、`minute` 和 `second` 查找。如果您的模型字段名为 `hour`、`minute` 或 `second`，新的查找可能会与您的字段名冲突。如果出现此问题，请附加一个明确的 [`exact`](/zh-hans/5.1/ref/models/querysets/#std-fieldlookup-exact) 查找。 ### `BooleanField` 不再默认为 `False` 当一个 [`BooleanField`](/zh-hans/5.1/ref/models/fields/#django.db.models.BooleanField) 没有明确的 [`default`](/zh-hans/5.1/ref/models/fields/#django.db.models.Field.default) 时，隐式的默认值是 `None`。在之前的 Django 版本中，默认值是 `False`，但这并没有准确地表示缺少值。 依赖默认值为 `False` 的代码在保存新的模型实例到数据库时可能会引发异常，因为 `None` 不是 [`BooleanField`](/zh-hans/5.1/ref/models/fields/#django.db.models.BooleanField) 的可接受值。您应该在字段定义中明确指定 `default=False`，或者在保存对象之前确保字段被设置为 `True` 或 `False`。 ### 模板中的翻译和注释 #### 提取注释后的翻译内容 使用 [`makemessages`](/zh-hans/5.1/ref/django-admin/#django-admin-makemessages) 命令从模板中提取可翻译文字时，现在可以正确检测到位于同一行的 `{#` / `#}` 类型的注释之后的 i18n 构造。例如： ```html+django {# A comment #}{% trans "This literal was incorrectly ignored. Not anymore" %} ``` #### 翻译者注释的位置 [模板内对翻译的注释](/zh-hans/5.1/topics/i18n/translation/#translator-comments-in-templates) 使用 `{#` / `#}` 指定的注释必须位于一行的末尾。如果不是，这些注释将被忽略，并且 [`makemessages`](/zh-hans/5.1/ref/django-admin/#django-admin-makemessages) 将生成警告。例如： ```html+django {# Translators: This is ignored #}{% trans "Translate me" %} {{ title }}{# Translators: Extracted and associated with 'Welcome' below #}

{% trans "Welcome" %}

``` ### `reverse()` 中的引号 在反查 URL 时，Django 在将参数插入 URL 模式之前未应用 `django.utils.http.urlquote`。这个 bug 在 Django 1.6 中已经修复。如果你之前通过在将参数传递给 `reverse()` 之前应用 URL 引用来解决这个问题，这可能导致双重引用。如果发生这种情况，请从你的代码中移除 URL 引用。你还需要将在 [`assertRedirects()`](/zh-hans/5.1/topics/testing/tools/#django.test.SimpleTestCase.assertRedirects) 中使用的 URL 中的特殊字符替换为它们的编码版本。 ### 在评论应用中存储 IP 地址 评论应用现在使用 `GenericIPAddressField` 来存储评论者的IP地址，以支持从 IPv6 地址提交的评论。直到现在，它们是存储在 `IPAddressField` 中的，这个字段只支持 IPv4。当保存来自 IPv6 地址的评论时，在 MySQL 数据库上，该地址将被静默截断，并在 Oracle 上引发异常。你需要更改数据库中的列类型才能从这个更改中受益。 对于 MySQL，在您的项目数据库上执行以下查询： ```sql ALTER TABLE django_comments MODIFY ip_address VARCHAR(39); ``` 对于 Oracle，请执行以下查询： ```sql ALTER TABLE DJANGO_COMMENTS MODIFY (ip_address VARCHAR2(39)); ``` 如果您不应用此更改，行为将保持不变：在 MySQL 上，IPv6 地址会被静默截断；在 Oracle 上，会生成异常。对于 SQLite 或 PostgreSQL 数据库，不需要进行数据库更改。 ### 在 `cursor.execute` 查询中的百分比文字面值 当你通过 [cursor.execute](/zh-hans/5.1/topics/db/sql/#executing-custom-sql) 方法运行原始 SQL 查询时，关于在查询内部加倍百分比文字面值（`%`）的规则已经统一。过去的行为取决于数据库后端。现在，在所有后端中，只有在你还提供替换参数的情况下，才需要加倍文字百分比字符。例如： ``` # No parameters, no percent doubling cursor.execute("SELECT foo FROM bar WHERE baz = '30%'") # Parameters passed, non-placeholders have to be doubled cursor.execute("SELECT foo FROM bar WHERE baz = '30%%' and id = %s", [self.id]) ``` `SQLite` 用户需要检查和更新这样的查询。 ### 对于 ManyToManyField 字段的模型表单字段的帮助文本。 HTML 渲染模型表单字段，对应于用于获取硬编码句子的 [`ManyToManyField`](/zh-hans/5.1/ref/models/fields/#django.db.models.ManyToManyField) 模型字段： > *按住 "Control" 键，或者在 Mac 上按住 "Command" 键，以选择多个选项。* （或其翻译成活动语言环境的版本）将作为帮助提示显示在它们旁边，如果用户没有指定 [`model`](/zh-hans/5.1/ref/models/fields/#django.db.models.Field.help_text) 或 [`form`](/zh-hans/5.1/ref/forms/fields/#django.forms.Field.help_text) `help_text` 属性（或者该字符串被附加到任何已提供的 `help_text` 中）。 由于这发生在模型层，因此无法阻止文本在不适用的情况下出现，例如实现了不涉及键盘和/或鼠标的用户交互的表单字段。 从 Django 1.6 开始，作为临时的向后兼容性规定，添加 "按住..." 句子的逻辑已经移动到模型表单字段层，并修改为仅在关联的小部件为 [`SelectMultiple`](/zh-hans/5.1/ref/forms/widgets/#django.forms.SelectMultiple) 或其选定的子类时添加文本。 如果您为依赖于提供的硬编码句子的自动方式的 `ManyToManyField` 模型字段使用自定义模型表单字段和/或小部件，这个变更可以以向后不兼容的方式影响您。这些表单字段实现需要适应新的情况，通过提供自己的处理 `help_text` 属性的方式来处理它。 使用 Django [模型表单](/zh-hans/5.1/topics/forms/modelforms/) 功能以及 Django 内置的表单 [字段](/zh-hans/5.1/ref/forms/fields/) 和 [小部件](/zh-hans/5.1/ref/forms/widgets/) 的应用不受影响，但需要注意下面 [对于 ManyToManyField 字段的模型表单字段的帮助文本的调整](#m2m-help-text-deprecation) 中描述的内容。 ### QuerySet 迭代 `QuerySet` 的迭代方式已更改为立即将所有检索到的行转换为 `Model` 对象。在 Django 1.5 及之前，检索到的行是以 100 行为单位转换为 `Model` 对象的。 现有的代码将正常工作，但在某些用例中，转换为对象的行数可能会发生变化。这些用法包括部分遍历查询集或任何最终执行 `__bool__` 或 `__contains__` 操作的用法。 值得注意的是，大多数数据库后端在 1.5 版本中已经一次性获取了所有行。 仍然可以通过使用 [`iterator()`](/zh-hans/5.1/ref/models/querysets/#django.db.models.query.QuerySet.iterator) 方法来惰性地将检索到的行转换为 `Model` 对象。 ### [`BoundField.label_tag`](/zh-hans/5.1/ref/forms/api/#django.forms.BoundField.label_tag) 现在包括表单的 [`label_suffix`](/zh-hans/5.1/ref/forms/api/#django.forms.Form.label_suffix) 这与 [`Form.as_p`](/zh-hans/5.1/ref/forms/api/#django.forms.Form.as_p) 和 [`Form.as_ul`](/zh-hans/5.1/ref/forms/api/#django.forms.Form.as_ul) 等方法呈现标签的方式保持一致。 如果您在模板中手动呈现 `label_tag`： ```html+django {{ form.my_field.label_tag }}: {{ form.my_field }} ``` 在升级到 Django 1.6 时，你需要移除冒号（或你可能使用的任何其他分隔符），以避免重复。以下 Django 1.6 中的模板与 Django 1.5 中的上述模板渲染效果相同，只是冒号会出现在 `