认识项目与学习路线

学习目标

读完本章，你应能说清 Django 在网站中的职责，找到本站教程的源码入口，并建立一个与本站互不干扰的练习目录。本套教程不要求你做过 Django 项目；如果 Python 也刚起步，请先认真完成下一章。

为什么选择知行博客

博客的规模适合个人完成，同时包含真实应用的关键环节：访客阅读文章，注册用户写作，作者管理草稿，管理员审核评论。我们先让一张页面返回正确内容，再逐步接入数据库、账号、图片和接口，最后完成部署与恢复演练。学会这些边界，比一次安装很多插件更容易独立开发。

最终你会拥有：首页、搜索筛选、分页、文章详情、作者工作区、注册登录、密码重置、图片上传、审核评论、Admin、JSON API、自动化测试，以及 Docker/MySQL/Nginx 部署材料。课程中的账户注册会立即生效；本站已有的激活邮件、点选验证码、论坛通知和学习记录是后续扩展方向，不混入入门示例。

版本与官方依据

2026-11-01 核验的最新稳定版是 Django 6.1.2，本站也使用这个版本，实测 Python 为 3.14.10。本教程使用 Python 3.14 系列；Django 6.1.2 支持 Python 3.12、3.13、3.14。官方 6.1 文档中“6.1.3 起支持 Python 3.15”的表述不能用于推断 6.1.2 兼容 Python 3.15。

新特性会在适用位置介绍：第 20 章 MAILERS，第 22 章 fetch_mode，第 26 章 CSP，第 27 章模板片段，第 29 章 Tasks。CSP、模板片段和 Tasks 起于 6.0，不应称为 6.1 首次新增。本站仍使用旧 EMAIL_* 配置，教材单独展示 MAILERS；发布教材不会升级或改写本站配置。

具体怎么做：安排学习步骤

1. 阅读完整课程目录，按顺序完成前 21 章。每章“完整文件”表示本章新增或替换的文件，没列出的文件沿用上一章。
2. 在自己的工作目录新建 zhixing-blog，不要在 Django 中文网的源码目录执行练习迁移、初始化数据或删除命令。
3. 每完成一章，执行验收命令、记录结果，再用 Git 提交。遇到问题先核对虚拟环境、当前目录和文件路径。
4. 下载全部文稿与阶段代码。解压后的 django61/steps/NN/ 是每章变化的完整文件。工具可以累积这些文件，生成该章结束时的完整项目。

下面的命令在解压后的 django61 目录执行，目标必须是一个新的空目录。第 10 章以后的阶段包含迁移文件；还原代码不会复制你的数据库、密码和上传图片。

python tools/materialize.py --chapter 17 --output ../zhixing-ch17

生成后进入 ../zhixing-ch17，按第 3 章建立环境，执行 python manage.py migrate。不要把不同阶段的代码直接覆盖有重要数据的练习目录。完整项目的快捷启动方法放在第 36 章，第一次学习仍建议逐章实践。

本站和练习项目的关系

练习应用直接位于根目录，便于理解 Python 导入；本站通过配置加入 apps/ 搜索路径。理解了模块导入后再按团队需要调整布局，没有必要为了目录相同增加入门障碍。

本章新增或替换的完整文件

以下路径均相对于练习项目根目录。替换同名文件的全部内容；未列出的文件保持上一章版本。

本章不修改业务代码，按正文中的完整命令完成准备与验证。

如何确认成功

你能在本站找到 apps/course/models.py、apps/course/urls.py 和 templates/course/show.html，知道目录由 Category 保存、章节由 Course 保存，详情地址是 /course/show-编号.html。列出你准备给博客做的三个页面，以及每个页面谁可以访问。

练习：解释“网页”“视图函数”“模板”“数据库记录”各是什么，并画出一次打开文章页的简单顺序。预期顺序为浏览器请求、URL 匹配、视图读取记录、模板渲染、返回 HTML。

常见问题

精通是否意味着读完就掌握所有插件？ 不是。课程的终点是能独立完成一个有测试、权限和运维方案的项目，并知道遇到新问题去哪里查证。高并发、复杂任务队列和搜索引擎需要额外专项实践。

旧教程需要删除吗？ 不需要。本站旧教程有其历史版本，新教程独立标注版本，读者不应把不同版本的配置直接混用。

官方参考

• 当前稳定版
• Python 兼容范围
• Django 6.1 发布说明