第一步¶

你是 Django 或编程新手吗？从这里开始！

• 从零开始： 概述 | 安装

• 教程： 第 1 部分：请求和响应 | 第 2 部分：模型和管理站点 | 第 3 部分：视图和模板 | 第 4 部分：表单和通用视图 | 第 5 部分：测试 | 第 6 部分：静态文件 | 第 7 部分：自定义管理站点 | 第 8 部分：添加第三方包

• 高级教程： 如何编写可重用的应用 | 为 Django 贡献你的第一个代码

获取帮助¶

遇到问题？我们乐于提供帮助！

• 试试 常见问题解答 – 它包含许多常见问题的答案。

• 正在寻找特定信息？试试 索引、模块索引 或 详细目录。

• 没有找到任何内容？请参阅 常见问题解答：获取帮助，了解如何获取支持以及向社区提问。

• 在我们的 工单追踪器 中报告 Django 的错误。

文档组织方式¶

Django 有大量的文档。了解其组织方式的高级概述将帮助你找到所需内容。

• 教程 将引导你完成一系列步骤来创建一个 Web 应用程序。如果你不熟悉 Django 或 Web 应用程序开发，请从这里开始。另请参阅“第一步”。

• 主题指南 以相当高的层次讨论关键主题和概念，并提供有用的背景信息和解释。

• 参考指南 包含 Django 机制 API 和其他方面的技术参考。它们描述了其工作方式以及如何使用它，但假设你对关键概念有基本的了解。

• 操作指南 是食谱。它们指导你完成解决关键问题和用例的步骤。它们比教程更高级，并假设你对 Django 的工作原理有一定的了解。

模型层¶

Django 提供了一个抽象层（“模型”）用于构建和操作 Web 应用程序的数据。了解更多信息，请参见下文。

• 模型： 模型简介 | 字段类型 | 索引 | 元选项 | 模型类

• QuerySets： 执行查询 | QuerySet 方法参考 | 查找表达式

• 模型实例： 实例方法 | 访问相关对象

• 迁移： 迁移简介 | 操作参考 | SchemaEditor | 编写迁移

• 高级： 管理器 | 原始 SQL | 事务 | 聚合 | 搜索 | 自定义字段 | 多个数据库 | 自定义查找 | 查询表达式 | 条件表达式 | 数据库函数

• 其他： 支持的数据库 | 遗留数据库 | 提供初始数据 | 优化数据库访问 | PostgreSQL 特有功能

视图层¶

Django 有“视图”的概念，用于封装负责处理用户请求和返回响应的逻辑。通过以下链接查找你需要了解的关于视图的所有信息。

• 基础知识： URLconfs | 视图函数 | 快捷方式 | 装饰器 | 异步支持

• 参考： 内置视图 | 请求/响应对象 | TemplateResponse 对象

• 文件上传： 概述 | 文件对象 | 存储 API | 管理文件 | 自定义存储

• 基于类的视图： 概述 | 内置显示视图 | 内置编辑视图 | 使用 mixins | API 参考 | 扁平化索引

• 高级： 生成 CSV | 生成 PDF

• 中间件： 概述 | 内置中间件类

模板层¶

模板层提供了一种面向设计人员的语法，用于呈现要向用户展示的信息。了解设计人员如何使用此语法以及程序员如何扩展它。

• 基础知识： 概述

• 面向设计人员： 语言概述 | 内置标签和过滤器 | 人性化

• 面向程序员： 模板 API | 自定义标签和过滤器 | 自定义模板后端

表单¶

Django 提供了一个丰富的框架，方便创建表单和操作表单数据。

• 基础知识： 概述 | 表单 API | 内置字段 | 内置部件

• 高级： 模型表单 | 集成媒体 | 表单集 | 自定义验证

开发流程¶

了解各种组件和工具，以帮助你开发和测试 Django 应用程序。

• 设置： 概述 | 完整设置列表

• 应用程序： 概述

• 异常： 概述

• django-admin 和 manage.py： 概述 | 添加自定义命令

• 测试： 简介 | 编写和运行测试 | 包含的测试工具 | 高级主题

• 部署： 概述 | WSGI 服务器 | ASGI 服务器 | 部署静态文件 | 通过电子邮件跟踪代码错误 | 部署清单

管理员¶

查找关于 Django 最受欢迎功能之一——自动化管理员界面的所有你需要知道的信息。

• 管理员站点

• 管理员操作

• 管理员文档生成器

安全性¶

安全性在 Web 应用程序开发中至关重要，Django 提供多种保护工具和机制。

• 安全概述

• Django 中公开的安全问题

• 点击劫持保护

• 跨站请求伪造保护

• 加密签名

• 安全中间件

国际化和本地化¶

Django 提供强大的国际化和本地化框架，可帮助您开发面向多种语言和世界地区的应用程序。

• 概述 | 国际化 | 本地化 | 本地化的 Web UI 格式和表单输入

• 时区

性能和优化¶

有多种技术和工具可以帮助您更有效地运行代码——更快，并使用更少的系统资源。

• 性能和优化概述

地理框架¶

GeoDjango旨在成为世界一流的地理 Web 框架。其目标是尽可能轻松地构建 GIS Web 应用程序并利用空间启用数据的功能。

常见的 Web 应用程序工具¶

Django 提供 Web 应用程序开发中常用的多种工具。

• 身份验证： 概述 | 使用身份验证系统 | 密码管理 | 自定义身份验证 | API 参考

• 缓存

• 日志记录

• 发送电子邮件

• 联合供稿 (RSS/Atom)

• 分页

• 消息框架

• 序列化

• 会话

• 站点地图

• 静态文件管理

• 数据验证

其他核心功能¶

了解 Django 框架的其他一些核心功能。

• 条件内容处理

• 内容类型和泛型关系

• 静态页面

• 重定向

• 信号

• 系统检查框架

• 站点框架

• Django 中的 Unicode

Django 开源项目¶

了解 Django 项目本身的开发流程以及如何贡献。

• 社区： 为 Django 贡献代码 | 发布流程 | 团队组织 | Django 源代码仓库 | 安全策略 | 邮件列表和论坛

• 设计理念： 概述

• 文档： 关于本文档

• 第三方发行版： 概述

• Django 的发展历程： API 稳定性 | 发行说明和升级说明 | 弃用时间表