为什么不建议把仿真波形当唯一文档：波形无意图、无参数语境
这是芯片设计入门问答系列的一篇。和波形打交道的正确姿势，先看先仿真再综合：为什么仿真要走在最前面和怎么看懂一张仿真波形；本篇回答的是另一个层面的问题——波形能不能替代文档。
本文要回答的问题
- 波形里明明有全部信号变化，为什么还说它「不算文档」？
- 「波形无意图、无参数语境」具体指什么？
- 只靠波形交接设计，会在哪些环节翻车？
- 正确的做法是什么——波形在文档体系里应该站在什么位置？
问题与简短结论
问题：模块跑通了仿真，波形也存下来了，能不能就把波形截图或 VCD/FSDB 文件当作这个模块的「文档」交给下一个人？
结论：不能。 波形是「某一次仿真的信号轨迹记录」，它回答的是「这次跑的时候信号怎么跳」，而文档要回答的是「设计为什么这么写、什么条件下该是什么行为」。两者之间隔着意图、参数、版本、覆盖面四道鸿沟。波形是文档体系里的一类证据附件，而不是文档本身。
五条理由
1. 波形没有意图——只看得见「是什么」，看不见「应该是什么」
波形上的每一个跳变都是 DUT（被测设计）实际产生的行为。如果 RTL 里有个 bug，让 ready 在不该拉高的拍拉高了，波形会忠实地把这个错误跳变记录下来——它不会标红、不会报警，看波形的人如果不知道设计意图，就会把错误行为当成正确行为学走。文档的价值恰恰在于写下「应该怎样」：协议要求 valid 拉高后数据必须保持稳定直到握手完成，这句话波形说不出来。
2. 波形没有参数语境——脱离了激励与配置就失去意义
同一份 RTL，时钟周期 10ns 还是 4ns、FIFO 深度配置成 16 还是 64、复位打了几拍，波形长得完全不一样。一个 .fsdb 文件甩过来，不写清 testbench 怎么激励、参数怎么配、随机种子是多少，对方看到的只是一堆无法复现的曲线。参数语境是波形解释自己的前提，而这个前提只能由文字给出。
3. 波形只覆盖「跑过的那一次」——样本不是全集
仿真波形是单次运行的采样：用了哪组随机种子、触发了哪些分支、没触发哪些边界，全都藏在背后。拿一次正常路径的波形当文档，读者会以为模块只有这一种行为；那些没被激励打到的角落（复位中来了请求、背靠背传输、溢出边界）恰恰是新手最需要知道的部分。覆盖面问题要靠验证计划与覆盖率来回答，不是靠一份波形。
4. 波形不随版本演进—— diff 不出来，评审不了
设计文档是文本，改了一行需求描述，git diff 一眼可见，评审可以逐行评论。波形是二进制大文件（FSDB 动辄几百 MB），两次仿真之间的差异没法做文本级对比，也没法在评审会上逐条讨论「这个跳变从 v1.2 起为什么提前了一拍」。把波形当唯一文档，等于放弃了版本管理与评审这两个工程质量的基本盘。
5. 波形的检索成本极高——找一件事要拖半天进度条
文档有目录、有标题、能全文搜索；波形只有时间轴。想知道「这个模块对非法输入怎么处理」，看文档是翻到异常处理小节三十秒的事，看波形是打开波形器、回忆信号名、加载上百个信号、拖进度条碰运气的事。信息检索效率差了一个数量级以上。
下面这张对比卡把「波形当文档」和「正规设计文档」放在一起，差异一目了然。
读这张卡抓住一条主线：左栏的每一项短板，都对应右栏文档体系里一个成熟的补位机制——意图对应规格书、语境对应参数表、覆盖面对应验证计划、演进对应版本管理、检索对应目录结构。波形在这五件事上恰好全是空白。
波形在文档体系里的正确位置
把波形一棍子打死也不对——它是极好的证据材料。问题在于定位：波形应该挂在文档下面当附件和例证，而不是站在文档的位置上。下面这张分层图画出了一份合格的模块交付物长什么样。
这张图的分工是单向派生的：规格层的文字产生验证层的场景清单，场景清单跑完才留下证据层的波形和日志；波形对上层只有「例证回引」的作用——文档里说「复位期间忽略输入」，附一张复位场景的波形做佐证。一旦把这个层次倒过来，让波形自己当文档，上面两层的空白就再没有人填了。
一个真实的交接场景
某项目里，工程师 A 交付了一个 AXI 转 FIFO 的桥接模块：没有规格书，只有一句「波形在共享盘，行为照着看」。接手的 B 花了两周，踩了三个坑。第一，波形里 tready 在复位后第三拍就拉高，B 照此写了下游模块，联调时才发现那是 testbench 激励凑巧没在那几拍压数据，不是模块的真实能力——波形没告诉 B「这是侥幸路径」。第二，共享盘上有三个版本的 FSDB，文件名是 wave.fsdb、wave_new.fsdb、wave_final2.fsdb，没人说得清哪个对应哪版 RTL。第三，B 想问「背靠背写满时怎么反压」，三份波形里都没有这个场景，而 A 已经转岗。两周的排查量，一份两千字的接口文档加一个时序约定表就能避免。
这个例子里没有夸张成分，它对应的就是前面五条理由的逐一兑现：无意图（误学侥幸路径）、无版本（三份波形分不清）、无覆盖面（缺的场景正好是关键场景）。
常见误区
- 「波形是终极事实，文档会骗人。」 文档确实可能过时，但解法是评审加版本管理让文档保鲜，而不是换成一个天然无意图的载体。波形记录的「事实」还包含 bug 本身——没有文档对照，你连「波形里的行为对不对」都判不了。
- 「我把波形截图贴进 PPT 就算文档了。」 截图比原始波形更糟：连交互查看、加信号、量时序的能力都没了，只剩下一张无法验证的静态图片。
- 「小模块没必要写文档。」 文档成本和模块规模相关，但不为零。一个两百行的模块配半页接口约定加一段时序说明，半小时的事；省掉这半小时，交接方花的是以天计的时间。
- 「以后用断言/覆盖率自动生成文档就行。」 断言和覆盖率回答的是「验没验到」，仍然不回答「为什么这么设计」。工具能减少写文档的负担，不能消灭意图表达本身。
下面这张思维导图把「为什么不能只靠波形」的分支一次性收拢，方便记忆。
导图的右下分支是落脚点：否定「波形当唯一文档」不是否定波形，而是把它放回证据附件的位置——规格书写意图、验证计划列场景、波形负责在评审和交接时出示「那次确实这么跑过」。
延伸阅读
- 先仿真再综合：为什么仿真要走在最前面——波形从哪来，仿真在流程里的位置。
- 怎么看懂一张仿真波形——波形作为证据时该怎么读。
- 芯片设计规格书怎么写——真正承担「文档」职责的那份文件长什么样。
- 功能覆盖率与代码覆盖率的区别——回答「覆盖面」问题的正规机制。
- SystemVerilog 波形转储与 FSDB 控制——波形文件本身怎么生成、怎么控制大小。
- 芯片验证总览——验证体系里计划、覆盖率、证据各自的位置。
一句话总结
仿真波形是「某一次运行的行为轨迹」，它天然不带设计意图、参数语境、覆盖面说明，也无法版本化和检索，因此只能作为设计规格与验证文档的证据附件，绝不能充当模块的唯一文档——意图写在规格书里，场景列在验证计划里，波形只负责作证。