S10-A02 · 学习路线与团队准入

适用读者：要带新人、要定"能不能独立交付"标准的人。
前置：S10-A01。
覆盖旧文：A-1898（2026 年 Python 学习路线，29 点）。
覆盖扩展：E-S10-014（准入检查单）。
上一篇：S10-A01 · Web 框架选型 ADR（FastAPI / Flask / Django）
下一篇：S09 · Go 语言（下一系列）。

1. 一句话结论

路线要按"能交付什么"排，不按"知识点"排。判据是：D0 能跑、D7 能改、D30 能独立交付。

2. 六周路线（A-1898 的重排）

周	主题	交付物（可验收）
1	环境：conda/venv + 锁依赖（B01–B03）	一个新环境 + `requirements.txt`（精确版本）
2	最小 API：路由与校验（B04）	3 个端点 + 自动文档可访问
3	错误处理与日志（B05）	统一错误结构 + 请求日志
4	依赖治理与测试（J01）	CI 跑通：安装 + 单测
5	框架对照与迁移（J02）	把一个 Flask 端点迁到 FastAPI（含错误码对齐）
6	选型与复盘（A01）	一份 ADR（含被否方案）

原则：每周必须有"可运行产物"，否则第 4 周就会忘光前两周。

3. 准入清单（E-S10-014）

D0（当天）

能创建并激活环境，python -V 符合基线
能跑起示例 API 并 curl 通 3 个端点
能读懂 422 的 loc/msg/type

D7（一周）

能独立加一个端点（含参数校验与错误码）
能读懂一次 CI 失败并定位（依赖/测试/语法）
能解释 pip freeze 与 requirements.in 的区别

D30（一个月）

能独立交付一个服务（含文档、错误结构、测试）
能给出"依赖锁定"方案并解释代价
能写一份 ADR 并说清被否方案

判据：三项全过 = 可独立排期；任一项不过 → 配 pair 而非独挑。

4. 度量口径（避免"熟悉 Python"这类空话）

指标	定义	目标
首端点时长	从拿到需求到端点可测	≤ 1 天
环境重建成功率	新人按文档重建环境的成功次数	≥ 90%
CI 首跑通过率	首次提交 CI 通过比例	≥ 70%
代码返工率	CR 打回比例	≤ 30%

5. 五个误区

误区	真相
"先学语法再学框架"	语法可以在写端点中学；脱离产物学习留存低
"学完 Django 就会 FastAPI"	概念可迁移，但校验/异步/错误语义都要重建
"准入就是面试题"	准入应是"能交付"的检查单，不是背诵
"路线越全越好"	六周塞 10 个主题，等于什么都没学
"有文档就不用度量"	文档会过期，度量不会

6. 自检（架构师版）

为什么路线要按"交付物"排而不是按知识点？
D0/D7/D30 三档各自的门槛是什么？
四个度量指标里，哪个最能提前预警"新人要卡住"？
"熟悉 Python"为什么不能作为准入条件？
六周路线里哪一周最容易被人跳过？后果是什么？

7. 系列收尾

S10 到此结束（9 篇）。下一系列 S09 · Go 语言（36 张旧卡），从环境安装与类型系统开始，承接本系列的环境管理经验。

S10 的验收报告见 ../acceptance.md。

本篇属于系列《S10 · Python 语言与环境》，架构师层第 2 篇。旧文来源：A-1898；扩展点 E-S10-014。