整理模拟电子实验 5-9 时，页码、来源、预习理论和实测结果不能混在一起，不然报告很容易前后矛盾。
analog-lab-prelab-materials
整理实验指导书时，我以前很容易犯一个错误：看到一份 PDF，就想直接把它改写成“看起来完整”的材料。
标题、目的、原理、步骤、表格、结论，最好一口气都有。这样文档确实显得很整齐，但它也很容易把几件不同的事情揉在一起：指导书原文、预习报告、实验记录、正式报告、离线演示。
这几类材料看起来相近，用途却不一样。
尤其是还没上电、还没连线、还没实测的时候，预习报告里最不该出现的，就是那种“测量已经完成、结论已经成立”的语气。
第一步先核页码
批量拆实验指导书时，第一步应该很笨：先确认每个实验到底从哪一页开始，到哪一页结束。
这一步如果省掉，后面写得越漂亮，越可能错得越隐蔽。
我更愿意给每个实验留下三样东西：
- 独立拆出的原始 PDF。
- 原始文本或 OCR 文本。
- 页码核对文件，记录首页标题、末页内容和截图。
这些材料主要是给自己以后回头查用的，不是最后文档里的装饰。
比如一个实验从“基于运放的电阻型负反馈电路”开始，最后一页是预习要求；另一个实验是有源滤波器，末尾有图号和参数说明。只要这些页码、标题和末页内容没有核清楚，后面的整理就不能叫“实验 5 的材料”或“实验 6 的材料”，只能叫“从某段 PDF 里猜出来的材料”。
学习材料慢一点还能补，来源断掉就很难修。
预习报告只写还没发生的事
预习报告的作用，不是提前替正式报告收尾。
它应该回答的是：
- 这次实验想验证什么。
- 关键公式怎么来。
- 预期关系是什么。
- 上电前要核对哪些元件和引脚。
- 数据表格应该怎么留空。
这里可以有理论值，可以有推导，可以有检查清单，也可以有空白记录表。不过不能写实测结论。
一旦预习报告里出现完成式的实测描述，文档就开始混淆时间顺序。它看起来更完整，实际上更不可信。
我后来给自己定了一个很硬的规则：预习材料里只允许出现理论和准备动作。
表格可以留空，检查项可以列出来，公式可以推到最后一步；但任何需要硬件、仪器、连线、量程和实际读数支持的内容，都留给正式实验记录。
空白不是偷懒。
空白是在承认：这一步还没有发生。
离线演示不能冒充实测
批量整理实验时，有些内容可以用离线脚本做演示。
比如画一个理论幅频曲线，生成一组用于教学的合成波形，或者把公式关系变成一个小 HTML 页面。这些东西很有用，它能帮助预习时理解“如果参数这样取，曲线大概会怎样变”。
但离线演示和实测结果之间必须隔开。
离线演示可以叫：
synthetic demooffline estimatetheory preview它不该被写成：
completed measurementhardware capturefinal lab observation中文里也一样。
“理论预览”“离线示例”“合成波形”都可以；完成式的硬件采集和实测结论语气就不行。
我这么分，是因为两类材料来源不同。一个帮助理解，另一个来自正式测量。离线示例可以帮助你上手，但不能替代实验台上的读数。
把每个实验拆成同一套目录
批量整理最大的好处，是可以逼自己统一结构。
我比较喜欢把每个实验都拆成几层：
source：原始指导书、文本、页码核对assets：页截图和图像素材docs：清理版指导书、预习报告、预习展示scripts：离线演示脚本captures：演示数据reports：演示输出这样分目录不是为了好看，主要是让每类文件都有固定位置。
原始来源不能和改写版混在一起，预习文档不能和实测报告混在一起，离线演示不能和硬件采集混在一起。目录结构本身就是一种提醒：你现在处理的是原文、预习、演示，还是实测记录。
如果一个实验后面真的开始连线、测量、写正式报告，也应该新增对应的记录区，别把实测内容塞回预习报告里。
有疑点就标出来，别悄悄修正
PDF 拆出来以后，经常会遇到一些尴尬问题。
图号看起来不太对，公式排版有损坏，某个参数像是 OCR 读错，芯片型号和图里标注不完全一致。遇到这种情况，最糟的做法是直接“帮它改对”。
因为一旦改写后的文档看起来很顺，后面的人就很难知道原始材料哪里不确定。
更稳的做法是把疑点写成核查点：
- 图号需回看原 PDF。
- 参数需对照芯片手册。
- 表格单位需实验前再确认。
- 器件引脚需按实物或 datasheet 核对。
这类提醒会让文档看起来没那么“完美”，但后面回头查时会省很多事。它会把需要人工判断的位置亮出来，别悄悄替人做决定。
预习材料不是越完整越好
预习报告最好的状态，不是把正式报告提前写完。
它应该像一个上实验台前的工作夹：
- 理论关系已经整理好。
- 关键公式能顺着推。
- 元件和引脚知道要查哪里。
- 表格已经有栏位。
- 哪些值还没测，一眼能看出来。
这样上实验台时，人的注意力就可以放在连线、量程、波形和异常上，不用现场翻 PDF 找公式。
但它不会假装自己已经完成实验。
这个区分很重要。正式报告里最该写清楚的，是每个结论对应哪次测量、哪组数据。如果预习阶段就把结论写满，后面的实测反而失去了位置。
预习材料别假装已经测完
拆实验指导书时，先别急着把材料写成一份漂亮的完整报告。
先核页码，保留来源；再写清理版指导书；预习报告只放理论、检查项和空白表；离线演示只当理解工具；有疑点就标出来，别悄悄修正；实测结果等真的上电、连线、采集后再写。
这样整理出来的材料可能没那么像“成品”，但更适合学习。
因为它把时间顺序留住了：什么来自原始指导书，什么是预习推导，什么只是离线示例，什么要等到实验现场测完以后才能写。
实验文档一旦把这些东西分清楚，后面写正式报告时就不会一边补数据，一边怀疑自己到底是在记录事实，还是在圆一份提前写好的稿子。
继续读