---
title: "Django 文档"
version: 5.1
locale: zh-hans
source: https://docs.djangoproject.com/zh-hans/5.1/
canonical: https://djangodocs.dev/zh-hans/5.1/
---
# Django 文档

**你所需要知道的关于 Django 的一切。**

## 快速入门

你是刚学 Django 或是初学编程？ 这就是你开始学习的地方！

- **从零开始：** [概要](/zh-hans/5.1/intro/overview/) | [安装](/zh-hans/5.1/intro/install/)
- **入门教程：** [第 1 节：请求和响应](/zh-hans/5.1/intro/tutorial01/) | [第 2 节：模型和管理站点](/zh-hans/5.1/intro/tutorial02/) | [第 3 节：视图和模板](/zh-hans/5.1/intro/tutorial03/) | [第 4 节：表单和通用视图](/zh-hans/5.1/intro/tutorial04/) | [第 5 节：测试](/zh-hans/5.1/intro/tutorial05/) | [第 6 节：静态文件](/zh-hans/5.1/intro/tutorial06/) | [第 7 节：自定义管理站点](/zh-hans/5.1/intro/tutorial07/) | [第 8 节：添加第三方包](/zh-hans/5.1/intro/tutorial08/)
- **进阶教程：** [如何编写可复用的应用](/zh-hans/5.1/intro/reusable-apps/) | [提交你的第一个 Django 贡献](/zh-hans/5.1/intro/contributing/)

## 获取帮助

遇到问题？我们可以帮你！

- 试试 [FAQ](/zh-hans/5.1/faq/) —— 这里有很多常见问题的解答。
- 正在寻找特定的信息？试试 [Index](/zh-hans/5.1/genindex/)，[Module Index](/zh-hans/5.1/py-modindex/) 或者 [详细内容目录](/zh-hans/5.1/contents/)。
- 找不到解决方案？去 [FAQ：获取帮助](/zh-hans/5.1/faq/help/) 找找更多的帮助信息，也可以向社区寻求帮助。
- 在我们的 [ticket tracker](https://code.djangoproject.com/) 报告关于 Django 的 Bug。

## 这份文档是如何组织的

Django 有丰富的文档。一份高度概述的文档会告诉你在哪里找到特定的东西：

- [教程](/zh-hans/5.1/intro/) 通过一系列的步骤来带领你创建一个网页应用程序。如果你是 Django 或网页应用开发的新手，可以从这里开始。也可以看一下 “ [快速入门](#index-first-steps) ”。
- [专题指南](/zh-hans/5.1/topics/) 在相当高的层次上介绍关键主题和概念，并提供有用的背景信息和解释。
- [参考指南](/zh-hans/5.1/ref/) 包含 API 和 Django 各个工作机制方面的技术参考。它们介绍了 Django 是如何工作，如何被使用的。不过，你得先对关键字的概念有一定理解。
- [操作指南](/zh-hans/5.1/howto/) 是一份目录。它们以排列好的关键问题和用例的方式指导你。它们比教程更加深入，且需要你先了解一些关于 Django 是如何工作的知识。

## 模型层

Django 提供了一个抽象的模型（“models”）层，用于结构化和操作你的网页应用程序的数据。阅读下面内容了解更多：

- **模型：** [模型介绍](/zh-hans/5.1/topics/db/models/) | [字段类型](/zh-hans/5.1/ref/models/fields/) | [索引](/zh-hans/5.1/ref/models/indexes/) | [Meta 选项](/zh-hans/5.1/ref/models/options/) | [Model 类](/zh-hans/5.1/ref/models/class/)
- **QuerySet：** [执行查询](/zh-hans/5.1/topics/db/queries/) | [QuerySet 方法参考](/zh-hans/5.1/ref/models/querysets/) | [查询表达式](/zh-hans/5.1/ref/models/lookups/)
- **模型实例：** [实例方法](/zh-hans/5.1/ref/models/instances/) | [访问关联的对象](/zh-hans/5.1/ref/models/relations/)
- **迁移：** [迁移概述](/zh-hans/5.1/topics/migrations/) | [操作参考](/zh-hans/5.1/ref/migration-operations/) | [SchemaEditor](/zh-hans/5.1/ref/schema-editor/) | [编写迁移](/zh-hans/5.1/howto/writing-migrations/)
- **高级：** [管理器](/zh-hans/5.1/topics/db/managers/) | [原始 SQL](/zh-hans/5.1/topics/db/sql/) | [事务](/zh-hans/5.1/topics/db/transactions/) | [聚合](/zh-hans/5.1/topics/db/aggregation/) | [搜索](/zh-hans/5.1/topics/db/search/) | [自定义字段](/zh-hans/5.1/howto/custom-model-fields/) | [多个数据库](/zh-hans/5.1/topics/db/multi-db/) | [自定义查询](/zh-hans/5.1/howto/custom-lookups/) | [查询表达式](/zh-hans/5.1/ref/models/expressions/) | [条件表达式](/zh-hans/5.1/ref/models/conditional-expressions/) | [数据库函数](/zh-hans/5.1/ref/models/database-functions/)
- **其它：** [支持的数据库](/zh-hans/5.1/ref/databases/) | [旧数据库](/zh-hans/5.1/howto/legacy-databases/) | [提供初始化数据](/zh-hans/5.1/howto/initial-data/) | [优化数据库访问](/zh-hans/5.1/topics/db/optimization/) | [PostgreSQL 的特有功能](/zh-hans/5.1/ref/contrib/postgres/)

## 视图层

Django 具有 “视图” 的概念，负责处理用户的请求并返回响应。通过以下链接查找所有你需要知道的有关视图的信息：

- **基础：** [URL 配置](/zh-hans/5.1/topics/http/urls/) | [视图函数](/zh-hans/5.1/topics/http/views/) | [便捷工具](/zh-hans/5.1/topics/http/shortcuts/) | [装饰器](/zh-hans/5.1/topics/http/decorators/) | [异步支持](/zh-hans/5.1/topics/async/)
- **参考：** [内置视图](/zh-hans/5.1/ref/views/) | [请求／响应对象](/zh-hans/5.1/ref/request-response/) | [TemplateResponse 对象](/zh-hans/5.1/ref/template-response/)
- **文件上传：** [概览](/zh-hans/5.1/topics/http/file-uploads/) | [文件对象](/zh-hans/5.1/ref/files/file/) | [存储 API](/zh-hans/5.1/ref/files/storage/) | [管理文件](/zh-hans/5.1/topics/files/) | [自定义存储](/zh-hans/5.1/howto/custom-file-storage/)
- **基于类的视图：** [概览](/zh-hans/5.1/topics/class-based-views/) | [内置显示视图](/zh-hans/5.1/topics/class-based-views/generic-display/) | [内置编辑视图](/zh-hans/5.1/topics/class-based-views/generic-editing/) | [使用混入](/zh-hans/5.1/topics/class-based-views/mixins/) | [API 参考](/zh-hans/5.1/ref/class-based-views/) | [扁平化索引](/zh-hans/5.1/ref/class-based-views/flattened-index/)
- **高级：** [生成 CSV](/zh-hans/5.1/howto/outputting-csv/) | [生成 PDF](/zh-hans/5.1/howto/outputting-pdf/)
- **中间件：** [概览](/zh-hans/5.1/topics/http/middleware/) | [内建的中间件类](/zh-hans/5.1/ref/middleware/)

## 模板层

模板层提供了一个对设计者友好的语法用于渲染向用户呈现的信息。学习如何使用语法（面向设计者）以及如何扩展（面向程序员）：

- **基础：** [概述](/zh-hans/5.1/topics/templates/)
- **对于设计者：** [语法概述](/zh-hans/5.1/ref/templates/language/) | [内建标签及过滤器](/zh-hans/5.1/ref/templates/builtins/) | [人性化](/zh-hans/5.1/ref/contrib/humanize/)
- **对于开发者：** [模板 API](/zh-hans/5.1/ref/templates/api/) | [自定义标签和过滤器](/zh-hans/5.1/howto/custom-template-tags/) | [自定义模板后端](/zh-hans/5.1/howto/custom-template-backend/)

## 表单

Django 提供了一个丰富的框架来帮助创建表单和处理表单数据。

- **基础：** [概览](/zh-hans/5.1/topics/forms/) | [表单 API](/zh-hans/5.1/ref/forms/api/) | [内建字段](/zh-hans/5.1/ref/forms/fields/) | [内建部件](/zh-hans/5.1/ref/forms/widgets/)
- **进阶：** [针对模型的表单](/zh-hans/5.1/topics/forms/modelforms/) | [整合媒体](/zh-hans/5.1/topics/forms/media/) | [表单集](/zh-hans/5.1/topics/forms/formsets/) | [自定义验证](/zh-hans/5.1/ref/forms/validation/)

## 开发进程

学习众多的组件及工具，来帮助你开发和测试 Django 应用：

- **设置：** [概览](/zh-hans/5.1/topics/settings/) | [完整的设置列表](/zh-hans/5.1/ref/settings/)
- **应用程序：** [概览](/zh-hans/5.1/ref/applications/)
- **异常：** [概览](/zh-hans/5.1/ref/exceptions/)
- **django-admin.py 和 manage.py：** [概览](/zh-hans/5.1/ref/django-admin/) | [添加自定义命令](/zh-hans/5.1/howto/custom-management-commands/)
- **测试：** [介绍](/zh-hans/5.1/topics/testing/) | [书写并运行测试](/zh-hans/5.1/topics/testing/overview/) | [包含的测试工具](/zh-hans/5.1/topics/testing/tools/) | [高级主题](/zh-hans/5.1/topics/testing/advanced/)
- **部署：** [概述](/zh-hans/5.1/howto/deployment/) | [WSGI 服务器](/zh-hans/5.1/howto/deployment/wsgi/) | [ASGI 服务器](/zh-hans/5.1/howto/deployment/asgi/) | [部署静态文件](/zh-hans/5.1/howto/static-files/deployment/) | [使用 email 追踪代码错误](/zh-hans/5.1/howto/error-reporting/) | [部署检查清单](/zh-hans/5.1/howto/deployment/checklist/)

## 管理

找到所有你想知道的，关于自动化管理界面的知识，Django 最受欢迎的特性之一：

- [管理站点](/zh-hans/5.1/ref/contrib/admin/)
- [管理动作](/zh-hans/5.1/ref/contrib/admin/actions/)
- [管理文档生成器](/zh-hans/5.1/ref/contrib/admin/admindocs/)

## 安全

安全是网络应用程序开发中最重要的一个话题，Django 提供了多种保护工具和机制。

- [安全概览](/zh-hans/5.1/topics/security/)
- [在 Django 中披露的安全问题](/zh-hans/5.1/releases/security/)
- [点击劫持保护](/zh-hans/5.1/ref/clickjacking/)
- [跨站请求伪造 CSRF 保护](/zh-hans/5.1/ref/csrf/)
- [登录加密](/zh-hans/5.1/topics/signing/)
- [安全中间件](/zh-hans/5.1/ref/middleware/#security-middleware)

## 国际化和本地化

Django 提供了一个强大的国际化和本地化的框架, 以帮助您在多语言和世界各地区进行应用程序的开发：

- [概览](/zh-hans/5.1/topics/i18n/) | [国际化](/zh-hans/5.1/topics/i18n/translation/) | [本地化](/zh-hans/5.1/topics/i18n/translation/#how-to-create-language-files) | [本地化的网页用户界面格式和表单输入](/zh-hans/5.1/topics/i18n/formatting/)
- [时区](/zh-hans/5.1/topics/i18n/timezones/)

## 性能和优化

有各种各样的技术和工具，可以帮助你的代码的运行更高效，更快和使用更少的系统资源.

- [性能和优化概述](/zh-hans/5.1/topics/performance/)

## 地理框架

[GeoDjango](/zh-hans/5.1/ref/contrib/gis/) 旨在成为一个世界级的地理网络框架。它的目标是使建立 GIS 网页应用尽可能容易，并利用空间数据的力量。

## 常见的网络应用工具

Django 提供了网络应用程序开发中普遍需要的多种工具：

- **认证：** [概述](/zh-hans/5.1/topics/auth/) | [使用认证系统](/zh-hans/5.1/topics/auth/default/) | [密码管理](/zh-hans/5.1/topics/auth/passwords/) | [自定义认证](/zh-hans/5.1/topics/auth/customizing/) | [API 参考](/zh-hans/5.1/ref/contrib/auth/)
- [缓存](/zh-hans/5.1/topics/cache/)
- [日志](/zh-hans/5.1/topics/logging/)
- [发送邮件](/zh-hans/5.1/topics/email/)
- [资讯聚合 (RSS/Atom)](/zh-hans/5.1/ref/contrib/syndication/)
- [分页](/zh-hans/5.1/topics/pagination/)
- [消息框架](/zh-hans/5.1/ref/contrib/messages/)
- [序列化](/zh-hans/5.1/topics/serialization/)
- [会话](/zh-hans/5.1/topics/http/sessions/)
- [站点地图](/zh-hans/5.1/ref/contrib/sitemaps/)
- [静态文件管理](/zh-hans/5.1/ref/contrib/staticfiles/)
- [数据验证](/zh-hans/5.1/ref/validators/)

## 其它核心功能

了解更多 Django 框架的其他核心功能 :

- [有条件的内容处理](/zh-hans/5.1/topics/conditional-view-processing/)
- [内容类型和通用关系](/zh-hans/5.1/ref/contrib/contenttypes/)
- [简单页面](/zh-hans/5.1/ref/contrib/flatpages/)
- [重定向](/zh-hans/5.1/ref/contrib/redirects/)
- [信号](/zh-hans/5.1/topics/signals/)
- [系统检查框架](/zh-hans/5.1/topics/checks/)
- [站点框架](/zh-hans/5.1/ref/contrib/sites/)
- [Django 中的 Unicode](/zh-hans/5.1/ref/unicode/)

## Django 开源项目

了解 Django 项目本身的开发进程以及你如何为 Django 做贡献：

- **社区：** [为 Django 做出贡献](/zh-hans/5.1/internals/contributing/) | [发布进程](/zh-hans/5.1/internals/release-process/) | [团队组织](/zh-hans/5.1/internals/organization/) | [Django 源代码仓库](/zh-hans/5.1/internals/git/) | [安全政策](/zh-hans/5.1/internals/security/) | [邮件列表和论坛](/zh-hans/5.1/internals/mailing-lists/)
- **设计哲学：** [概览](/zh-hans/5.1/misc/design-philosophies/)
- **文档：** [关于本文档](/zh-hans/5.1/internals/contributing/writing-documentation/)
- **第三方发行：** [概览](/zh-hans/5.1/misc/distributions/)
- **Django 时间线：** [API 稳定性](/zh-hans/5.1/misc/api-stability/) | [发行说明和升级说明](/zh-hans/5.1/releases/) | [过时时间表](/zh-hans/5.1/internals/deprecation/)