Django-快速迭代开发过程
这篇讲什么
- 这篇不是 Django 的代码教程,而是「怎么把一个 Django 项目按天推进下去」的方法:怎么判断核心功能(OOPD)、怎么做技术方案设计与工作拆解、怎么保证交付质量并持续迭代。
- 里面每个名词都会解释一遍(OOPD、0day、Fail fast、Buffer、灰度、A/B Test、Feature Flag),并且落到 Django 的具体做法上——迁移文件怎么支撑「逐步演进」、功能开关怎么实现、哪些检查该进 CI。
- 这篇属于经验总结,没有需要实机验证的技术断言;文中提到的 Django 侧命令(迁移、测试、
check --deploy、覆盖率)都在同目录的《Django-生产环境要注意哪些事项》《Django-云环境中的持续集成》里逐条实测过,这里只引用结论。 - 工具名与书名按当前官方拼写校正过:
Astash应为 Astah,Lucid Chart应为 Lucidchart,Widipedia应为 Wikipedia。
快速迭代的价值与挑战
什么是快速迭代
以「天」甚至「小时」为单位持续把可用的改动交付到用户手里,并从中获得反馈的循环。反面是「攒三个月做一次大版本」。
1.2 价值
- 时间是最贵的成本:机会窗口很短,早一步拿到市场反馈就早一步决定要不要继续投。
- 快速验证需求:避免把资源投在用户其实不需要的功能上(
Fail fast, fail better:尽早失败,并且失败得便宜)。 - 快速验证方案:技术选型靠真实小实验,不靠会议室争论。
- 缩短反馈回路:团队和自己能持续拿到「有进展」的正反馈,这本身就是效率来源。
1.3 挑战
- 产品设计者要能理清业务流程、抓住重点需求,并把「客户想要什么」翻译成「系统要做什么」——这两句话经常不是一回事。
- 开发者既要理解业务,又要能用足够简洁的方案做系统:复杂方案短期也能跑,但迭代速度会被它拖死。
根本挑战
- 市场、用户、技术、环境变化快,开发节奏很难追上。
- 几乎没有人能一开始就设计出「适应未来长期变化」的完美方案。
- 也很少有人愿意承认「我现在的能力/条件还做不出完美产品」——于是把时间花在打磨细节上,而不是尽快拿到反馈。
用 OOPD 方法识别产品核心功能
OOPD 是什么
OOPD = Online and Offline Integrated Product Development(线上与线下结合的产品开发)。核心思路是:产品决策不靠内部讨论拍板,而是「线下想清楚 → 线上小步验证 → 用真实数据回到线下修正」的闭环。

五条原则
| 原则 | 含义 | 落地做法 |
|---|---|---|
| 自助原则 | 自己做自己用的产品(eat your own dog food) | 内部先用,团队是第一批用户 |
| 0day 原则 | 抓住核心问题、砍掉一切细节,第一天就发布 | 首版只做主流程跑通,其它一律排后 |
| 时限原则 | 设定时间盒,不给「写出 bug」留拖延空间 | 一个迭代 1~2 周,任务拆到 0.5~1 天 |
| 不完美原则 | 没有完美产品,别为完美消耗宝贵资源 | 明确「这版不解决什么」并写进文档 |
| 谦卑原则 | 承认自己的局限,靠用户反馈持续修正 | 建反馈入口,看数据不看面子 |
对 Django 项目来说,「0day 原则」最常见的落点就是:先把「一个模型 + 一个列表页 + 一个表单页」跑通上线,而不是先做权限体系、后台美化、导出报表。
技术方案设计与工作拆解
做设计的前提
- 有明确的用户场景:用户怎么和产品交互,期望拿到什么结果。
- 有清晰的业务流程:谁在什么时候做什么,数据从哪来到哪去。
缺这两条就开始画架构图,产出通常是「看起来专业但没人能照着写代码」的文档。
设计流程

3.3 工具
常见工具:Visual Paradigm、Lucidchart、Visio、Gliffy、Draw.io、Astah、StarUML 等。
推荐工具:白板或白纸。不用工具往往是最好的工具——画得快的图才会被真的更新,精美的图往往在需求变更后就作废了。要留档再补到仓库里(Markdown + 简单流程图即可,和站内笔记的做法一致)。
技术方案文档的要素
- 产品背景:用户场景、产品目标、引用的业务流程与需求文档。
- 要解决的问题列表、明确不解决的问题列表、系统约束。
- 不同方案的对比,以及每个主要问题最终怎么解决。
- 整体流程图(序列图)、模块关系图、关键接口与实体的概念定义。
- 功能之外的设计:安全、性能、可维护性、稳定性、监控、扩展性、易用性。

Django 项目里这一节最实际的产出是三样东西:实体关系(模型清单)、页面/接口清单、以及「哪些事情这版不做」。
工作拆解
任何事只要拆得足够细,你就能完成它。拆解原则:
- 优先级:主流程上不确定的工作优先做(建议提前一个迭代做技术调研,把风险前置)。
- 核心流程优先:先把主流程打通,再补边角。
- 减少依赖:降低任务之间的人依赖,团队拆解保持透明,预留 20% 的 Buffer(缓冲时间,用来吸收估算误差与临时插入的事)。
- 粒度:拆到每项 0.5~1 天,最长不超过 2 天;超过 2 天说明还没拆透。
对 Django 项目,一个自然的切分边界就是「一个模型 + 它的视图/表单/测试」,这样每个任务都能独立提交、独立评审、独立回滚。
怎么保证交付质量
- 需求质量决定软件质量:需求含糊时,代码只是把模糊实现了一遍。
- 架构方案要评审:系统设计决定实现质量,重大改动先写半页方案再动手。
- 工程侧的持续交付实践:
| 实践 | 具体做法 | 备注 |
|---|---|---|
| Code Review | 每次提交都被评审;单次 commit 小于 200 行;提交要频繁 | 小提交才看得懂,也才好回滚 |
| 单元测试 | 项目第一天就建好测试机制,并在 CI 自动跑 | 基类怎么选、跑法与退出码见《Django-生产环境要注意哪些事项》第七节 |
| 自动化回归 | 对预发/线上做 API 或页面级自动测试(Postman、Robot Framework、Playwright 等) | 覆盖「改 A 坏 B」 |
| CI/CD | 自动打包、测试、部署、线上验证 | 六条必跑命令见《Django-云环境中的持续集成》 |
- 发布过程可监控、可回滚:先有指标和日志,再谈快速发布。
- 灰度:用户量大的产品先放小比例流量。
- 限流与降级:对意外并发做保护(Nginx
limit_req实测见《Django-生产环境中的安全》第九节)。 - 配置开关(Feature Flag):功能能通过配置实时开/关,让「代码上线」与「功能上线」解耦。
- A/B Test:用数据比较两个版本的效果,而不是靠感觉。
- 一切自动化、一切代码化:配置即代码、部署流程即代码、基础设施即代码(声明式 API、CI Pipeline、K8s、Helm、Terraform)。
Django 里怎么实现功能开关
不必引入重型框架,一个配置表 + 缓存就够用:
1 | class FeatureFlag(models.Model): |
1 | if FeatureFlag.is_on("new_checkout"): |
要点:开关状态走缓存(实测 locmem 在多 worker 下各自一份,所以开关必须用 Redis 之类共享后端,否则不同实例表现不一致),并且每个开关都要有「关掉后的老路径」,否则它就不是开关而是发布。
用迁移支撑「逐步演进」
快速迭代意味着模型会一直变,Django 的 migrations 就是为这件事设计的:
-
加字段先给默认值或允许为空,避免锁表和旧代码报错。
-
删字段拆两次发布:先停用,再删除。
-
数据修补写进
RunPython,配atomic=True。 -
CI 用
python manage.py makemigrations --check --dry-run拦住「改了模型忘了生成迁移」(实测退出码 1)。
把方法落到一周节奏里
一个可执行的最小节奏(两周迭代也能压缩成一周):
-
周一:确认本迭代要交付的 3~5 个「用户可见结果」,每个都能演示。
-
周一:为不确定的技术点排 0.5 天调研,结论写半页纸。
-
每天:小步提交(< 200 行)、当天被评审、CI 全绿才合。
-
周三:把已完成部分发到内部环境,团队自己先用(自助原则)。
-
周五:灰度上线 + 看指标;不达预期就关开关,而不是连夜改。
-
周五:15 分钟回顾——哪个估算错了、为什么,写进下一轮的 Buffer。
这份节奏的价值不在形式,而在于每个环节都有明确的失败信号:CI 红、指标不动、内部没人用,任一条出现就该停下来调整范围,而不是继续加功能。
常见误区
- 把「拆得很细」当成「拆得好」:细碎但都依赖同一个人的任务表,等于没拆。
- 用完美的架构图替代真实原型:图不会给你反馈,上线的东西才会。
- 一上来就做权限体系、报表导出、后台美化:这些几乎都不是核心问题。
- 把 Buffer 当成摸鱼时间:Buffer 是用来吸收意外的,不是用来塞新需求的。
- 只有「大重构」没有「小步演进」:Django 项目里能靠迁移和开关解决的事,就不要憋成一次重写。
- 忽略可观测性:迭代越快,越需要「出问题能立刻发现」,见《Django-接入监控告警》。
参考
- Django 官方:迁移:模型演进与零停机发布的关系。
- Django 官方:测试工具:单元测试机制的建立方式。
- Django 官方:缓存框架:功能开关与配置缓存的实现基础。
- The Lean Startup(精益创业):Eric Ries,快速验证与「最小可行产品」的来源。
- 《The Pragmatic Programmer 程序员修炼之道》(Andrew Hunt / David Thomas)。
- 《启示录:打造用户喜爱的产品》(Marty Cagan)。
- 《黑客与画家》(Paul Graham)。