第四章：目录与版本历史——自动生成目录技巧、版本变更记录表、修订说明
大家好，我是老张。这一章咱们聊聊文档里两个容易被忽视、但实际工作中特别重要的部分——目录和版本历史。
你可能觉得，目录嘛，Word里点一下自动生成不就行了？版本历史，不就是改个日期吗？
嗯，我以前也这么想。直到有一次，我拿着一个设计报告去评审，评审专家翻了半天找不到关键参数在哪。还有一次，客户拿着旧版本的设计文件来质问我们为什么改了参数没通知……从那以后，我对这两块内容再也不敢马虎了。
4.1 自动生成目录的技巧
先说目录。Zemax设计报告动辄几十页，手动编目录？不现实。我个人的习惯是：用Word的样式功能配合自动目录生成。
具体怎么做？我简单说几个要点：
- 统一标题样式： 所有一级标题用“标题1”，二级用“标题2”，以此类推。别一会儿用黑体，一会儿用宋体加粗，那样目录生成会出问题。
- 利用多级列表： 在Word里设置多级列表，关联到标题样式。这样“第一章”、“1.1”、“1.1.1”会自动编号，不用手动敲。
- 更新域代码： 每次修改完内容，记得右键点击目录，选择“更新域”——“更新整个目录”。我见过有人忘了这步，提交的目录页码全是错的，尴尬得很。
- 目录深度控制： 一般设计报告，目录显示到三级标题就够了。太深了反而显得啰嗦。
4.2 版本变更记录表
版本变更记录表，说白了就是这份文档的“身份证”。谁改的、什么时候改的、改了啥、为什么改，都得写清楚。
我曾经在一个项目里，因为版本记录没写清楚，导致生产部门用了旧版本的光学参数，做出来的样品全部报废。那次教训太深刻了。
下面是我常用的版本变更记录表模板：
| 版本号 | 日期 | 修改人 | 修改内容 | 修改原因 |
|---|---|---|---|---|
| V1.0 | 2024-01-15 | 张工 | 初版创建 | 项目启动，首次提交设计报告 |
| V1.1 | 2024-01-22 | 李工 | 更新MTF曲线数据 | 根据实测结果修正仿真参数 |
| V2.0 | 2024-02-10 | 张工 | 重新优化镜片间距，调整公差分析结果 | 客户要求提升良率至95%以上 |
你看，这个表格虽然简单，但信息很完整。我建议你养成一个习惯：每次修改文档，第一时间更新这个表。别等到最后再补，那时候你很可能已经忘了改过什么。
4.3 修订说明
修订说明，是版本变更记录表的“升级版”。它不光记录改了啥，还要解释清楚为什么这么改，以及对设计有什么影响。
举个例子：
假设你修改了某个镜片的曲率半径。在版本变更记录表里，你可能只写“修改R1值”。但在修订说明里，你得写清楚：
- 原来的R1值是多少？
- 改成多少了？
- 为什么改？（比如：原设计像散过大，优化后像质提升）
- 这个改动对其他参数有什么影响？（比如：后焦距变了，需要重新调整机械结构）
我个人习惯把修订说明放在文档的前言部分，紧跟在版本变更记录表后面。这样读者一打开文档，就能知道这份报告和上一版有什么不同。
4.4 一些实用建议
好了，理论说完了。最后分享几个我在实际项目中总结的经验：
- 目录和版本历史，放在文档最前面。 别藏在附录里，那样就失去了它们“导航”和“溯源”的意义。
- 版本号要跟设计文件同步。 比如你的Zemax文件是“Project_V2.0.zmx”，那设计报告也应该是“Project_V2.0.docx”。别搞混了。
- 每次提交给客户或评审前，检查一遍目录页码。 我吃过这个亏——目录显示“第10页”，实际内容在第12页。评审专家当场就指出了这个低级错误。
- 如果团队协作，用共享文档或版本管理工具。 别用微信传来传去，那样版本会乱成一锅粥。
嗯，这一章的内容就这些。目录和版本历史虽然看起来不起眼，但它们是专业性的体现。你想想看，一份连目录都乱七八糟的报告，别人会相信里面的设计数据吗？
下一章，咱们聊聊设计报告的核心——系统参数与性能指标的编写规范。到时候我会拿一个实际的光学系统案例，一步步教你怎么写。