“#@save”：从“魔法注释”到源码调试的全过程

在阅读《动手学深度学习》（Dive into Deep Learning，简称 D2L）这本书时，相信很多读者和我一样，会对代码单元格里那句#@save感到好奇。它既像是一行普通的注释，又像是作者施下的“魔法”，能在后续章节里直接让我们用import d2l调出各种工具函数。今天，我们就从“是什么、怎么实现、怎么找、怎么调”四个维度，彻底剖析这个标记背后的工程哲学。一、它不是魔法，而是“工具包收纳箱”#@save的本质上是一个编译/构建时的打包标记。作者为了让书本的代码块保持干净整洁，不让大量重复的底层工具代码（比如画图、数据迭代器）占据篇幅，特意设计了这个标记。当构建工具在生成书籍时，会把所有标注了#@save的函数、类提取出来，统一打包成一个独立的 Python 包，名字就叫d2l。对读者来说，它的体验极好：你永远不用为了一个画图函数，在笔记本里重复抄写几十行繁琐的代码，只需import d2l并直接调用即可。二、封装的过程，仅仅是“换了条路径”吗？很多读者以为代码只是被复制到了另一个文件夹，但其实它经历了一个**“提取-重组-包装”**的复杂工程流水线：正则提取：构建工具（d2lbook