website

Django Docs

所属分类:开发者在线工具箱

Django 官方文档,提供入门教程、主题指南与模型视图等参考资料。

Django Docs 是 Django Web 框架的官方文档站,默认显示 6.1 版,同时保留 6.0 至 1.8 的旧版本和开发版文档。新手可以从八篇入门教程开始,有具体问题时再按模型、视图、查询等主题查阅指南与参考资料。

Django Docs:Django 官方文档,按入门教程、主题指南和参考手册查找用法

发布于 2026年10月18日更新于 2026年10月29日

从零开始:概述、安装与八篇教程

首页的 “First steps” 部分指向 Overview(概述)和 Installation(安装),随后列出名为 “Writing your first Django app” 的八篇教程,即 Part 1 至 Part 8。另有两篇进阶教程:如何编写可复用的应用(How to write reusable apps),以及为 Django 写第一个贡献(Writing your first contribution to Django)。

第二篇教程从设置数据库和创建第一个模型开始,并介绍 Django 自动生成的管理后台(admin site)。教程说明默认数据库为 SQLite,它随 Python 一起提供,初学者无需额外安装;同时提醒,正式项目可以考虑 PostgreSQL 这类更具扩展性的数据库。

第八篇教程讲解第三方包的安装,以社区维护的 Django Debug Toolbar 为例。教程用 python -m pip install django-debug-toolbar 安装,并说明这类包通常需要把应用加入 INSTALLED_APPS,有时还要修改 URLconf。

Django 官方文档首页截图,顶部为 Django 站点导航和 DOCUMENTATION 栏目,正文为 Django documentation 标题,下方依次为 First steps、Getting help 与文档分类说明

按主题查模型与视图

“Models” 页面说明,模型是数据的唯一权威来源,包含所存数据的基本字段和行为,一般每个模型对应数据库中的一张表。页面以定义 Person 类(含 first_name 与 last_name 字段)为例,说明模型类继承 django.db.models.Model,类上的每个属性代表一个字段。

首页按层组织主题。模型层包括 Models、Field types、Indexes、Meta options,查询相关的 QuerySets、Making queries 与 Lookup expressions,迁移相关的 Migrations,以及 Managers、Transactions、Aggregation 等进阶内容。视图层包括 URLconfs、视图函数、快捷函数、装饰器和异步支持,还有内置视图、请求与响应对象、文件上传和存储 API,以及基于类的视图(Class-based views)。

文档类型与查找方式

首页用四类文档分别回答不同问题。教程(Tutorials)带读者一步步完成一个应用;主题指南(Topic guides)讨论关键概念并提供背景;参考资料(Reference guides)给出 API 的技术细节;操作指南(How-to guides)则针对具体问题给出步骤。

页面右上角有搜索框(快捷键 Ctrl+K),也可切换明暗主题。右侧的 Browse 栏可以按顺序翻到上一篇或下一篇,并提供目录、总索引(General Index)和 Python 模块索引(Python Module Index)。站点还提供语言切换,列表中包括简体中文(zh-hans)、日文、韩文、法文和西班牙文等版本。

遇到问题时

“Getting help” 部分推荐先阅读 FAQ,其中有常见问题的答案。想找具体条目可以使用总索引、模块索引或完整目录。确认是 Django 本身的缺陷时,可以到官方的工单系统(ticket tracker)提交。

Django 教程第八部分页面截图,标题为 Writing your first Django app, part 8,正文讲解 Django Debug Toolbar 的安装命令