这门课从零制作一个“学习记录小助手”：输入主题与学习分钟数，保存记录，再查看总时长。它没有漂亮界面，但每一步你都能看见数据如何变化，并解释代码为什么得到这个结果。
课堂的方法主线从 《揭开黑盒》 开始。本课程提供需要时可以取用的 Python 语法与实践，不要求你先完成八课才能观察系统。
不会运行脚本时查 01；读不懂参数与返回值时查 04；分不清内存对象和文件时查 05；遇到异常与验证时查 06、08。也可以沿下面的顺序完整做出一个工具，再把它作为自己的调查对象。
| 课 | 上一步还不能做什么 | 本课增加的能力 | 交付证据 |
|---|---|---|---|
| 01 | 代码只是文件里的文字 | 用解释器运行它 | 终端显示两行预期文本 |
| 02 | 每次换数据都要重写整句 | 变量、计算、判断目标是否完成 | 25 与 60 分钟走不同分支 |
| 03 | 只能处理一条记录 | 列表、字典、循环累加 | 3 条记录合计 60 分钟 |
| 04 | 汇总代码难以重复使用 | 函数、参数、返回值、入口 | 同一函数处理样例与空列表 |
| 05 | 数据只能写在程序里 | 从 JSON 文件读取记录 | 改数据文件即可改变统计 |
| 06 | 错误数据也能参与统计 | 校验、异常、清晰报错 | 拒绝负数、数字字符串和空主题 |
| 07 | 仍需改代码才能录入 | 命令行参数与文件保存 | 连续启动两次，记录仍在 |
| 08 | 不知道改动是否破坏旧功能 | 行为测试与独立扩展 | 筛选任务通过同一组验收 |
每一课只把主线向前推进一小步。完整版本先放在教材中，讲义逐步解释它为什么需要这些部分。不会要求你先装复杂框架、找业务项目、配置 AI 服务。
在课程目录点击“下载整门课”，解压 ZIP。进入：
python-starter/
00-学习路线.md
01-运行第一个程序.md
...
assets/
starter-lab/
README.md
tracker.py
study_core.py
versions/
data/
practice/
tests/本课所有运行命令，默认终端当前目录是 assets/starter-lab/。不要仅仅在编辑器中打开文件，却把终端留在别处。01 课会解释怎样确认。
Windows 用 py -3，macOS/Linux 用 python3。以下讲义统一写 Windows 命令；另两种系统替换命令开头即可，路径统一使用 /。需要 Python 3.10 或更新版本。
建议每课记录三行：我预测什么、实际发生什么、差异由哪一步造成。比记住所有语法名称更有用。
你应能独立执行以下过程：创建空记录，加入两条记录，重新启动程序后查询统计；遇到缺文件或非法分钟数时，能指出输入、出错位置和改法。
最后的自动验收只检查约定的行为，不能代替理解。08 课还要求你解释输入经过哪些函数、哪一行发生文件写入、为什么错误输入没有改坏旧记录。
如果你已能解释字符串和整数的差异、遍历字典列表、写返回值函数，可从 05 开始。若你能独立运行项目测试并完成 practice/task.py，可直接进入《代码课堂》的 01 课。
Python 基础通过后，推荐主线是：代码课堂 01 读代码 → 02 HTTP → 04 SQLite → 05 网页调用 → 08 FastAPI → 12 工程化。03 的 MVC 是前端分工专题，06/07 是包结构与桌面分支，AI 与 React 分支随后按前置要求进入。
JavaScript、浏览器 DOM 和 React 不会因为你学完 Python 就自动掌握。进入那些课时，先做其小实验，再读大型项目摘录。
保留完整命令、当前目录、错误最后几行、自己改过的内容。不要一遇到错误就重新安装全部环境。后续各课会区分找不到文件、语法错误、类型错误、数据错误和权限错误。
参考代码中的数据是教学用虚构记录；可以任意复制实验。修改前保留原文件，练习不要使用重要个人数据。