00 · 怎么用这份教程

⏱ 36 分钟 ｜ ⭐ 这不是 Python 入门 —— 是「你已经会写了，但它还是会咬你」的那十个地方

🎯 一句话

站里其余 15 个板块讲的是「用 Python 表达一个想法」，这一套讲「Python 自己是怎么运作的」。 因为那些板块里每一次崩、每一次慢、每一次「我这能跑你那不能跑」，都不是模型的问题，是这一层的问题。

⏱ 先说清楚这套的章比站内其他板块长（普遍 50–120 分钟，站内其他板块的中位是 30）—— 因为每个知识点都带实跑代码和真实报错，压不下去。设计上就没打算让你一次读完： 超过 55 分钟的章在中间有 🛑 休息点，最长的几章有两个，停在那里下次接着读就行。 徽章是按 170 字/分钟实测校准的，宁可吓到你，也不骗你。

🧩 一、这一套是怎么立起来的

站内 15 个板块的导读章几乎都写着同一句话：「需要会写几十行 Python」。

然后就没有然后了。没有任何一个板块负责那几十行。于是出现这样的分布：

⭐ 最能说明问题的一条：机器学习与深度学习基础 的 附录B-代码速查 有一整节叫「⚡ 提速」，给了混合精度、torch.compile、n_jobs=-1 三招 —— 却没有一行教你怎么测量。按它改完，你无法判断改对没有。

⭐ 立项判据不是「这些知识重要」，是「站内第 X 章第 Y 句依赖了它，而站内没人讲」。 后面每一章开头都会告诉你它接的是站内哪一句话。

🚦 二、三道自测题：先判断这套适不适合你

不用查资料，先在心里回答，再跑一遍。三题里错一题以上，这一套就是给你写的。

# 三道自测题：先猜，再跑
import threading, time

# ① 可变默认参数
def f(x, seen=[]):
    seen.append(x)
    return seen
print("①", f(1), f(2), f(3))

# ② 生成器只能走一次
g = (i * i for i in range(5))
print("②", sum(g), "然后再来一次:", sum(g))

# ③ 纯 Python 的 CPU 活，多线程比串行快吗
def burn(n=2_000_000):
    s = 0.0
    for i in range(n):
        s += i * i
    return s

t0 = time.perf_counter(); [burn() for _ in range(4)]
serial = time.perf_counter() - t0

t0 = time.perf_counter()
ts = [threading.Thread(target=burn) for _ in range(4)]
[t.start() for t in ts]; [t.join() for t in ts]
threaded = time.perf_counter() - t0
print("③ 串行 %.2f s ｜ 4 线程 %.2f s" % (serial, threaded))

本机（8 核 Windows / CPython 3.13）实际输出：

⚠️ 三题的共同点：都不报错。这正是这一层最贵的地方 —— 报错的 bug 会被你修掉，不报错的会一直待在那里。

🗺️ 三、章节地图（11 章）

正文 10 章合计 856 分钟 ≈ 14.3 小时；含本章 892 分钟 ≈ 14.9 小时（章内有 🛑 断点，设计上就是分次读）。

章与章的依赖（不想全读时看这个）：

📋 四、三条读法路线

⭐ 别按 01→10 顺着读，除非你就是想通读。按你现在遇到的问题挑一条：

路线 A ｜「线上崩了，我要能查」（约 288 分钟，分几次读）

07 异常与 traceback → 10 编码、路径和文件 → 01 名字与绑定 → 08 环境与 import

先学会读现场（07），再认出最高频的两类现场：编码炸掉（10）和「两个名字指着同一个对象」（01），最后是「换台机器就不行」（08）。

路线 B ｜「脚本太慢，我要它快起来」（约 370 分钟，分几次读）

⭐ 05 怎么量 → 04 GIL 与并发选择 → 02 生成器 → 09 容器与哈希

⚠️ 05 必须放第一个。不先量就改，你改的九成不是瓶颈 —— 05 章有个实跑例子：剖析器自己的开销会把两段代码的快慢顺序颠倒过来。

路线 C ｜「把一次性脚本变成别人能用的东西」（约 390 分钟，分几次读）

08 环境与依赖 → 06 类型标注 → 03 装饰器与上下文管理器 → 07 异常

别人能装上（08）→ 别人能看懂接口（06）→ 你能给它加横切能力（03）→ 出事时别人能查（07）。

🧯 五、四条分工线：什么归这里，什么不归

⭐ 越界就是重复内容，所以这几条写死在这里：

还有三处是站内已经讲透的，本板块只链过去不重做：

🛠️ 六、明确不讲什么

免得你翻半天找不到：

📐 七、关于本板块里的数字

⚠️ 这一套里所有「实测」数字都是在同一台机器上真跑出来的，环境写在这里，方便你判断差多少算正常：

⭐ 你的绝对数值一定和这里不同 —— 每一处要看的都是相对关系（谁比谁快几倍、峰值内存差几个数量级），不是秒数本身。 最后两行本身就是 10 章 的正题：本仓库有过一次站点从 156 张图掉到 75 张的事故，根因就是那两行。

🔗 这一章连到哪里

✅ 检查点

1. 这一套的立项判据是什么？为什么「这个知识重要」不算证据？
2. 三道自测题分别考的是哪三章？它们有什么共同点？
3. 第 ① 题为什么三次都返回 [1, 2, 3]？
4. 第 ③ 题在本机的实测结果是什么？和大多数人的直觉差在哪？
5. 三条读法路线分别是什么场景？路线 B 为什么必须把 05 章放第一个？
6. 「名字绑到对象」和「缓冲区被共享」为什么要分给两个不同的板块？
7. 本板块明确不讲哪五类东西？async 的完整体系归哪里？
8. 为什么章里的绝对秒数不用去对？

🛑 可以停在这里

⚡ 走神救援

这一套的定位：站里其余板块讲「用 Python 表达一个想法」，它讲「Python 自己是怎么运作的」——⭐ 因为那些板块里每一次崩、每一次慢、每一次「我这能跑你那不能跑」，都不是模型的问题，是这一层的问题。

⭐⭐ 立项判据不是「这个知识重要」，而是「站内第 X 章第 Y 句依赖了它，而站内没人讲」：yield 全站十几处全在 SSE 流式里用着，没有一处讲它何时暂停；某一章让你亲手造一个工具装饰器，而闭包和签名反射站内一处没讲；DQN 那一行深拷贝写错会让目标网络静默失效——不报错、loss 还在降、只是学不出来；还有一批词全站命中为 0。⭐ 最能说明问题的一条：某个附录有一整节叫「提速」，给了三招却没有一行教怎么测量。

三道自测题判定这套适不适合你：可变默认参数会跨调用累积、生成器只能消费一次而第二次求和是 0 且不报错、纯 CPU 活开多线程和串行一样慢。⚠️⭐ 三题的共同点是都不报错——报错的 bug 会被你修掉，不报错的会一直待着。

⭐ 别顺着读，挑一条按问题分的路线：线上崩了要能查 / 脚本太慢 / 把脚本变成别人能用的东西。⚠️ 第二条里测量那一章必须第一个——不先量就改，改的九成不是瓶颈。

四条分工线：「名字绑到对象」归本板块、「缓冲区被共享」归 NumPy、「谁负责释放」归 C++、计时与剖析方法论整块归本板块；async、结构化日志、pytest 都只链过去不重做。

⚠️ 所有数字都在一台机器上实跑，你要看的是相对关系不是秒数；⭐ 而那台机器的默认编码不是 UTF-8 这件事本身就是最后一章的正题——本仓库因此有过一次站点图掉了一半的事故。

下一节 👉 01-名字、对象和绑定.md