Django 5.0.x Documentation

• 语言: 英语
• 格式: .epub
• 来源: media.readthedocs.org

摘要

文档详细说明了Django 5.0版本的新功能、向后兼容性更改以及废弃的功能。Django 5.0支持Python 3.10、3.11和3.12，推荐使用最新版本。新版本引入了Facet filters、简化了表单字段的渲染，并对多项-admin功能进行了改进。此外，文档还详细介绍了如何查找和生成本地文档，包括使用Sphinx生成HTML文档以及通过grep实用工具进行搜索。

AI总结

以下是对《Django 5.0.x Documentation》的总结，重点突出核心观点和关键信息：

---

### **Django 5.0 简要概览**
1. **兼容性和设置**：
- Django 5.0 默认启用 `USE_TZ`（时区支持），但可以在项目设置中设为 `False` 以选择退出。
- `USE_L10N` 默认值变为 `True`，并已弃用，表示所有日期和数字显示将默认本地化。
-.default sitemap 协议从 `http` 更改为 `https`。

2. **弃用和移除**：
- `SERIALIZE` 测试设置已弃用，可通过数据库的 `serialized_rollback` 选项推断。
- `django.utils.baseconv` 和 `django.utils.datetime_safe` 模块已弃用。
- `extra_tests` 参数在 `DiscoverRunner` 中已弃用。
- `ArrayAgg`、`JSONBAgg` 和 `StringAgg`聚合函数在无数据时返回 `None`，需显式设置 `default` 以保留旧行为。
- `GeoModelAdmin` 和 `OSMGeoAdmin` 类已弃用，建议使用 `ModelAdmin` 和 `GISModelAdmin`。
- 表单渲染使用模板引擎后，`BaseForm._html_output()` 方法已弃用。
- `ErrorList` 和 `ErrorDict` 返回 `str` 的能力已弃用，建议返回 `SafeString`。

3. **新特性**：
- **admin 显示_facets筛选**：在 admin 更改列表中，筛选面板显示统计信息，可通过 `ModelAdmin.show_facets` 控制。
- **模板简化**：引入字段组（field group）和字段组模板，简化了表单字段渲染。
- **admin 高级功能**：
- `ModelAdmin.ListFilter` 支持自定义查询字符串值分隔符。
- admin 历史视图支持分页。
- 相关 widget wrappers 链接到对象的 change 表单。
- `AdminSite.get_app_list()` 允许更改 admin 索引页上的应用和模型顺序。
- **安全性与认证**：PBKDF2 密码哈希迭代次数从 320,000 增加到 390,000。
- **GIS 新增功能**：`GEOSGeometry.make_valid()` 方法可将无效几何转换为有效几何；`normalize()` 方法支持克隆normalizedGeometry。
- **PostgreSQL 新增聚合函数**：`BitXor` 返回所有非Null输入值的按位异或结果；`SpGistIndex` 支持 PostgreSQL 14+ 的覆盖索引。

4. **Python 兼容性**：
- Django 5.0 支持 Python 3.10、3.11 和 3.12。
- 第三方应用应drop支持 Django 4.2 之前的版本，并确保兼容性。

5. **文档与开发**：
- Django 文档分为多种类型，包括入门材料、主题指南、模板文档等，适合不同需求的开发者。
- 文档通过 Sphinx 生成 HTML，可本地查看或在线访问（如 [https://docs.djangoproject.com](https://docs.djangoproject.com)）。
-文档更新策略：主分支的文档反映最新功能，旧版本文档在不再支持后停止更新。

---

以上总结涵盖了 Django 5.0 的核心改动、弃用特性、新功能和文档组织，旨在提供一个清晰、完整且易于理解的概览。