Django 4.2.x Documentation

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

摘要

文档阐述了Django 4.2.x版本的主要特性和变更，包括新功能的引入、旧特性的弃用、版本发布周期的调整以及配置设置的变更。其中，Django 4.2是一个长期支持版本，支持多个Python版本，并引入了对Psycopg 3的支持。同时，文档详细说明了如何查找和使用Django的官方文档，包括使用索引、搜索功能以及本地访问方式。版本发布-notes部分记录了各个版本的错误修复和新功能，帮助开发者了解每个版本的更新内容。

AI总结

以下是对文档内容的简要总结：

---

### Django 4.2.x 文档总结

#### 1. **版本更新与变更**
Django 4.2是一个长期支持（LTS）版本，将获得至少三年的安全更新支持。支持的Python版本包括3.8、3.9、3.10和3.11。以下是重要的变更和移除内容：
- **移除内容**：
- `BaseUserManager.make_random_password()` 方法
- 模型的 `Meta.index_together` 选项
- `length_is` 模板过滤器
- `SHA1PasswordHasher`、`UnsaltedSHA1PasswordHasher` 和 `UnsaltedMD5PasswordHasher` 密码哈希器
- `CICharField`、`CIEmailField` 和 `CITextField` 模型字段
- `map_width` 和 `map_height` 属性
- `SimpleTestCase.assertFormsetError()` 和 `TransactionTestCase.assertQuerysetEqual()` 方法
- **其他变更**：
- 支持通过 `psycopg 3.1.8` 连接 PostgreSQL 数据库，未来可能弃用 `psycopg2`。
- 新增 `Field.db_comment` 和 `Meta.db_table_comment` 选项，用于在数据库列和表上添加注释。

---

#### 2. **补丁更新说明**
Django 4.2.2 版本主要修复了多个回归问题，包括：
- 由于 `JSONField` 子类的 `get_prep_value()` 调用问题导致的ORM性能回归。
- 在 `Oracle` 数据库中对 `TextField` 和 `BinaryField` 的 `__isnull` 和 `__exact=None` 查询中的不必要包装问题。
- 查询集在 `ManyToManyField` 或 `GenericForeignKey` 引用时的崩溃问题。
- 其他与查询集的 `only()`、`defer()`、`aggregate()` 方法相关的崩溃问题。
- `makemigrations --update` 未尊重 `--name` 选项的问题。

---

#### 3. **文档与学习路径**
Django 文档内容丰富，涵盖了从入门到高级的各个方面，推荐学习路径如下：
- **入门材料**：适合新手，提供高层次的开发概览。
- **主题指南**：深入探讨 Django 的各个核心模块，如模型系统、模板引擎、表单框架等。
- **发布说明**：详细记录每个版本的新功能和向后不兼容的更改。
- **教程**：分步骤从零开始创建一个完整的网应用。

---

#### 4. **文档获取与使用**
Django 文档提供以下几种获取方式：
1. **网上文档**：最新版本可以通过 [Django 官方网站](https://docs.djangoproject.com/en/dev/) 访问。
2. **本地文档**：可以通过 Django 源代码仓库的 `docs/` 目录获取，支持纯文本和 HTML 格式。
3. **搜索与索引**：使用内置搜索功能或浏览-index快速定位所需内容。

---

#### 5. **社区支持**
- **问题反馈**：通过 Django 的 ticket 系统提交文档改进建议或修复请求。
- **获取帮助**：可以通过 `django-users` 邮件列表或 `#django` IRC 频道获取技术支持。
- **报告错误**：在 Django 的 ticket 追踪系统中报告 bug。

---

以上为文档的核心内容和关键信息。