配套仓库与使用说明

配套仓库 保存各章的示例程序、完整项目、运行所需的练习数据，以及第二至十八章全部 122 项练习的推导与参考实现。正文用来按步骤学习，仓库方便下载运行和逐题核对。读到本章例子时，先找到对应文件；完成章末练习后，再打开相应题解。

按章节查找文件

仓库首页的“按章查阅”表，每章都有“程序索引”和“习题解答”入口。也可以直接打开 配套程序总索引 或 练习查阅索引。网页中的文件名可以继续点击，下载到本地后，索引中的相对链接仍然可以使用。

示例索引中的“片段”与正文代码块对应，有的承接前面已经定义的变量或函数。学习时沿正文顺序阅读；运行一个完整任务时，选择索引中列出的完整 .py 文件，或进入项目目录按其中的 README.md 操作。这样可以看到导入、数据文件与启动入口怎样组合起来。

下载与打开目录

初次使用可以点击仓库页面的 Code → Download ZIP，也可以直接 下载配套仓库 ZIP。解压后得到 python-modern-notes-examples-main 目录，里面是 README.md 和 examples。保留这些目录的相对位置，后面的数据读取、跨文件导入和题解链接会用到它们。学到第七章后，也可以用 Git 克隆仓库，并通过拉取提交取得更新。

在 VS Code 中选择“文件 → 打开文件夹”，打开要学习的程序目录。运行基础语法示例时，可以打开 examples/基础语法；运行完整项目时，打开该项目自己的目录。再选择“终端 → 新建终端”，核对当前所在的目录与正文要求一致。例如打开 reading_summary.py 后，终端也应位于它所在的 基础语法 目录，才能按下面的文件名运行。

运行单文件与完整项目

完成第一章的 Python 3.12 环境准备后，可以先试运行 阅读时长统计程序。这个例子只用 Python 自带的功能，程序本身在第二章逐步讲解。在 Windows 终端中执行：

# 在 examples/基础语法 目录中，用 Python 3.12 启动统计程序。
py -3.12 reading_summary.py

随后依次输入 3、20、35、45，每个数字单独一行。3 表示接下来有三天的数据；程序读完后，输出总时长 100、平均时长 33.33、达标天数 2 和最长时长 45。先按这组输入核对，再把其中一天的时长改掉，预测哪些输出会变化。macOS/Linux 中把启动命令里的 py -3.12 换成 python3.12。

从需要第三方包的章节开始，完整项目各自保存依赖声明与运行说明。先进入所选项目，再按它的 README.md 准备环境。例如第一章的 uv 配套项目 位于 examples/环境管理/reading-uv，该目录中同时有 pyproject.toml、uv.lock 和 main.py：

# 在 reading-uv 目录中，按项目保存的依赖记录建立 .venv。
uv sync --locked
# 用刚准备好的项目环境运行 main.py，核对 HTTPX 的版本。
uv run main.py

这段程序输出 0.28.1。第一章会分别解释依赖声明、锁定文件和 .venv 的作用，并给出 pip + venv 的对应操作。后面的 Web、数据和模型项目也按各自说明运行：每个项目建立自己的环境，VS Code 选择该项目 .venv 中的解释器，启动命令从该项目目录执行。下载的是源文件与依赖记录，.venv 由这些记录在本机生成。

按题号查阅解答

每章末尾的“本章习题解答与推导”链接直接进入本章题解。总索引使用“章号－题号”定位，例如 03-01 表示第三章第一题“最长连续达标天数”。打开 03-01 的题解，会依次看到“题目”“推导与做法”“实现与运行”。

先独立完成，再用同一份输入比较中间状态，随后查看带注释的实现。题解里的命令同时说明工作目录和题号；有些练习共用一份章节代码文件，通过题号选择要运行的部分，有些练习则修改前面的完整项目。按本题说明进入目录后再执行。网页中折叠的“查看本题运行结果”可以展开，用来核对计算结果、请求响应或保存后的状态。

需要集中查找启动命令、数据位置和常见报错时，翻到附录；完成第一轮项目后，后记按六个方向列出后续任务与官方资料。下面的学习路线帮助选择当前阶段要读的章节。