实验仓库要按任务分层#

这个仓库的公开 README 里把内容按实验拆开：

1
exp1_instrumentation_amp/
2
exp2_state_variable_filter/
3
hspice/
4
report_assets/

这样的结构比“所有文件都放根目录”好很多。每个实验有自己的仿真文件、设计笔记和结果目录，公共的工具说明和报告素材再单独放。

对模拟电路实验来说，目录结构最好直接反映工作流：

• 题目和指标。
• 设计笔记。
• 仿真网表或电路文件。
• 结果文件。
• 报告素材。
• 最后报告。

这样以后回看时，不需要先猜一个文件是哪个实验留下的。

网表比截图更值得保存#

报告里的截图能说明波形长什么样，但真正想重跑时，还是得靠网表和仿真设置。

更应该保存的是网表、电路文件、仿真命令和结果数据。截图可以帮助阅读，但它不能告诉你当时的元件参数、模型引用、扫描设置和仿真选项。

优先保留这些内容：

• HSPICE .sp 网表。
• LTspice .cir 或电路文件。
• 仿真输出日志。
• 关键结果数据。
• 用于报告的图表素材。

这样即使报告已经写完，后面仍然可以重新跑仿真、改参数、对比结果。

HSPICE 和 LTspice 要分清角色#

这个仓库里同时出现了 HSPICE 和 LTspice。它们适合不同场景：

• HSPICE 更适合严肃网表仿真、模型文件和批处理输出。
• LTspice 更适合交互式搭电路、快速扫频和波形查看。

课程实验里经常会混用工具。关键是别让工具差异把结论搅乱。比如同一个指标如果在 HSPICE 和 LTspice 中都出现，就要写清楚仿真条件、模型来源、读取位置和单位。

所以仓库里最好写清楚：这次结果是用哪个工具、哪套模型、哪个读数位置算出来的。

本地配置不该写死进正文#

仿真器路径、模型库路径、许可证环境、安装位置，这些东西通常和机器绑定。

如果把它们直接写进报告或脚本正文，换一台电脑就很容易坏。更好的方式是把本地配置抽出来：

1
project files + example config + local ignored config

公开仓库里可以放示例配置和说明，但真实本地路径、安装包、许可证相关文件、临时输出和大体积本地资源都应该排除。这样仓库既能说明如何运行，又不会把个人环境混进公共材料。

这个范围对课程实验也很重要。很多实验文件一开始只是自用，但一旦放进 GitHub，就必须按公开仓库来处理。

别把有用的输出全删光#

很多人会把仿真输出全删掉，只保留最后报告。这样仓库很干净，但证据也断了。

当然，所有中间文件都提交也不现实。比较稳的做法是保留能支撑主要结论的结果文件：

• 关键 .lis 或日志摘要。
• 关键波形导出的数据。
• 报告中用到的图表素材。
• 参数调整前后的代表性结果。

以后再看报告里的图，至少还能顺着数据文件找到它是怎么跑出来的。

报告不该是唯一成果#

课程最后可能只要求交一份报告，但对自己来说，报告只是最后一层。

更完整的实验成果应该包括：

• 可运行的仿真输入。
• 可追溯的设计笔记。
• 可检查的结果文件。
• 可复用的报告素材。
• 最后报告。

报告适合阅读，仓库适合复现。两者不是替代关系。

把实验仓库整理好以后，下次遇到类似电路，就不需要从空白开始。你可以直接看当时怎么定指标、怎么搭网表、怎么读增益、怎么处理异常结果。

小心公开仓库里的范围#

模拟电路实验仓库很容易不小心混入不该公开的东西：

• 本机绝对路径。
• 私有模型库。
• 许可证配置。
• 安装包和大体积资源。
• 带个人信息的报告封面。
• 课程群或老师给的非公开资料。

公开前最好做一次清理：保留自己写的设计、脚本、网表和回看，去掉本地环境、授权相关文件和个人信息。

公开仓库时，别人应该看到的是实验怎么做出来的，而不是你的本机路径和许可证配置。

为什么需要记录成博客#

这类仓库最适合写博客，因为它不只是记录做过哪些实验，也能把当时怎么调参数、怎么看结果写下来。

比如仪表放大器实验，可以写指标分解、共模抑制、仿真验证；状态变量滤波器实验，可以写通带增益、中心峰值、Q 和带宽的读取位置。每篇文章都不需要很大，只要把一个易错点讲清楚。

analog-circuit-labs 最需要留下的地方就在这里：它把课程实验从一次性交付整理成日后还能回看、复现、继续写的材料。