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

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

## 获取帮助

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

- 试试 [FAQ](/zh-hans/2.0/faq/) —— 这里有很多常见问题的解答。
- 正在寻找特定的信息？试试 [Index](/zh-hans/2.0/genindex/)，[Module Index](/zh-hans/2.0/py-modindex/) 或者 [详细内容目录](/zh-hans/2.0/contents/)。
- 在 [django-users](/zh-hans/2.0/internals/mailing-lists/#django-users-mailing-list) 邮件列表的档案库搜索，或者 [post a question](https://groups.google.com/d/forum/django-users)。
- 在 [#django IRC Channnel](irc://irc.freenode.net/django) 提问，或者搜索 [IRC logs](https://botbot.me/freenode/django/) 看看是否已经有人问过类似的问题。
- 在我们的 [ticket tracker](https://code.djangoproject.com/) 报告关于 Django 的 Bug。

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

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

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

## 快速入门

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

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

## 模型层

Django 提供了一个抽象的模型 ("models") 层，为了构建和操纵你的Web应用的数据。阅读下面内容了解更多：

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

## 视图层

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

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

## 模板层

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

- **基础：** [概述](/zh-hans/2.0/topics/templates/)
- **对于设计者:** [语法概述](/zh-hans/2.0/ref/templates/language/) | [内建标签及过滤器（filters）](/zh-hans/2.0/ref/templates/builtins/) | [人性化](/zh-hans/2.0/ref/contrib/humanize/)
- **针对程序员:** [模板 API](/zh-hans/2.0/ref/templates/api/) | [自定义标签(tags)和过滤器(filters)](/zh-hans/2.0/howto/custom-template-tags/)

## 表单

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

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

## 开发进程

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

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

## 管理

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

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

## 安全

在 Web 应用的发展中，安全是最重要主题，Django 提供了多种保护手段和机制。

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

## 国际化和本地化

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

- [概览](/zh-hans/2.0/topics/i18n/) | [国际化](/zh-hans/2.0/topics/i18n/translation/) | [本地化](/zh-hans/2.0/topics/i18n/translation/#how-to-create-language-files) | [给 Web 界面及表单输入进行本地化](/zh-hans/2.0/topics/i18n/formatting/)
- [时区](/zh-hans/2.0/topics/i18n/timezones/)

## 性能和优化

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

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

## 地理框架

[GeoDjango](/zh-hans/2.0/ref/contrib/gis/) 想要成为一个世界级的地理 Web 框架。尽可能简化构建 GIS Web 应用程序的流程，和利用空间化数据的能力是它的目标。

## 常用的 Web 应用程序工具

Django 提供了多种开发 Web 应用程序所需的常用工具:

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

## 其它核心功能

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

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

## Django开源项目

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

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