覆盖率排除 pragma:coverage off/on、translate_off 内联排除写法与工具差异速查
更新时间:2026-10-06。代码覆盖率跑到 95% 以后,剩下的坑大多是「结构上不可达」或「故意不覆盖」的代码:FSM 的 default 分支、参数化永远关闭的 generate 分支、只给仿真用的调试逻辑。收尾手段有两类——仿真器的外部排除文件(exclusion file)和 RTL 里的内联 pragma。这一篇专讲后者:怎么写、各家语法差在哪、什么时候不该用。外部排除与合并流程见 覆盖率合并与排除流程,coverage closure 的整体打法见 功能覆盖率收敛计划。
本文要回答的问题
coverage off/on、translate_off/on各自排除什么,语义差在哪?- 各家仿真器(VCS、Xcelium、Questa)的内联 pragma 写法差多少?
- 内联 pragma 与外部排除文件怎么取舍?
- pragma 排除的审计纪律有哪些,怎么防「排除掩盖真 bug」?
一、两类 pragma 的语义边界
先分清两个经常被混用的东西。translate_off / translate_on(synopsys 系写法,也写作 pragma translate_off)是综合指令:告诉综合工具「这段代码别综合」,典型用途是仿真专用逻辑(断言、$display、延迟模型)。它只管综合,不管覆盖率统计——被 translate_off 包住的代码在仿真里照样跑、照样进覆盖率数据库。
覆盖率排除 pragma 是另一套:// synopsys coverage off 到 // synopsys coverage on 之间的代码,仿真器不生成覆盖率点(或生成后标记为排除),statement/branch/condition/toggle 各类覆盖都被踢出统计。它只影响覆盖率,不影响仿真行为,更不影响综合。速记:translate_off 管「这段代码存在不存在」,coverage pragma 管「这段代码算不算分」。
// synopsys coverage off
always_comb begin
unique case (state)
IDLE: nxt = RUN;
RUN: nxt = DONE;
default: nxt = IDLE; // 状态编码完备时 default 不可达
endcase
end
// synopsys coverage on
// synopsys translate_off
initial $display("sim-only banner"); // 综合忽略,与覆盖率无关
// synopsys translate_on二、各家语法速查
三大家的 pragma 长得不完全一样,且支持粒度不同。速查表:
| 工具 | 写法 | 备注 |
|---|---|---|
| VCS | // synopsys coverage off / on | 可加类型:coverage off -fstate 只排 FSM |
| Xcelium | // cadence coverage off / on | 也认 synopsys 前缀(兼容模式需开关) |
| Questa | // coverage off / // coverage on | 可加 bcft 字母选类型(branch/condition/FSM/toggle) |
| 通用 | // pragma coverage off / on | 三家基本都认的 LRM 风格写法 |
两个可移植性结论:写开源 IP 或需要跨工具的 RTL,用 // pragma coverage off/on 最稳;用了厂商前缀的写法,换工具时要全局 grep 一遍。另外所有工具都支持「单行排除」变体——把 // pragma coverage off 直接放在某一行末尾,只排除这一行,比包区块更精准,review 时也更容易看清排除了什么。
上图把两套 pragma 的分工画清了:coverage pragma 只动统计口径,translate_off 只动综合可见性;覆盖率收尾场景用错成 translate_off,统计里那几行照样红着。
三、内联 pragma 与外部排除文件的取舍
内联 pragma 的最大优点是「排除理由长在代码旁边」:任何人读 RTL 都能看到这段被排除了,配合一行注释说明原因,自解释性强。缺点同样明显:排除散落全库、EDA 工具换了要跟着改、且修改 RTL 本身需要走设计流程——验证工程师想排除一段代码,得提 RTL 变更单。外部排除文件(VCS 的 elfile、Xcelium 的 icc exclude、Questa 的 exclude do file)反过来:不改 RTL、集中管理、工具相关,但排除理由和代码分离,review 时得两边对照。集中式排除的治理见 覆盖率合并与排除流程。
工程上的通行取舍:设计源码里「结构性不可达」(编码完备的 default、常量 generate)用内联 pragma,因为它属于设计属性,跟着 IP 走天经地义;「项目级豁免」(本 SoC 不用的配置、本版本冻结的特性)用外部排除文件,因为它是项目决策,不该污染 IP 源码。两类都要有审计入口:pragma 用 grep 全量列出进评审,排除文件用工具自带的 exclude 报告进评审。
四、审计纪律:排除不能掩盖真 bug
pragma 是覆盖率数字的「合法作弊器」,所以红线必须画死。第一,每处 pragma 必须带注释写明理由与依据(「编码完备,default 不可达,见 spec 第 X 节」),无理由排除在评审一律打回。第二,排除范围最小化——能单行排除就不包区块,包区块时 off/on 紧贴目标代码,误伤相邻可覆盖代码是最常见的隐性事故。第三,签出前跑一次「排除清点」:grep 全部 coverage pragma 与外部排除文件合并出一张表,逐条确认仍然成立;曾经真实发生过参数改动后「不可达分支变可达」而 pragma 没跟着删,覆盖率统计漏了一块真代码。第四,排除只降分母不解决功能风险——被排除的逻辑如果行为存疑,正路是用断言或 FSM 覆盖率与断言 里的非法状态检查盯死它,而不是把它从分母里删掉装没看见。整体签出口径见 验证签出与覆盖率。
五、落地清单:从插 pragma 到签出
把一篇 pragma 排除的生命周期串成操作清单,团队可直接拿去当流程。第一步「先证明再排除」:准备排除某段代码前,先用工具报告确认它确实未覆盖,再给出不可达或豁免的技术依据——「覆盖率红着难看」不是依据,「该分支由参数 X=0 唯一控制、本项目 X 恒为 1」才是。第二步「最小范围插入」:单行能解决的问题用行尾形式,区块形式 off/on 之间不得超过必要的代码行数;插完重跑覆盖率,确认目标项消失且相邻项的覆盖率没掉——掉了说明范围框大了。第三步「注释即评审单」:pragma 上一行写清理由、依据出处、责任人,格式团队统一(比如 // COV-EXCL: default unreachable, encoding full, owner: zhang),便于 grep 汇总。第四步「入册」:把 grep 结果和外部排除文件合并成排除登记表,作为签出包的固定附件。第五步「参数变更复检」:任何影响可参数的 RTL 变更评审里加一项「既有排除是否仍然成立」,这是防「排除过期」的唯一机制。
还有一条跨项目的经验:IP 交付时 pragma 是交付物的一部分,集成方不应擅自增删——集成侧有新的豁免需求走自己的外部排除文件,两条轨道互不污染。这样 IP 升级换代时,排除清单随源码自然迁移,集成方的项目级豁免也完好保留,合并覆盖率数据库时各算各的账,扯皮最少。
六、与功能覆盖率排除的对照
顺手把功能覆盖率侧的「排除」对齐一下,避免两套语义混用。covergroup 里的 illegal_bins 是「出现即报错」、ignore_bins 是「不统计也不算错」,它们是采样语义的一部分,写进覆盖率模型源码;而代码覆盖率的 pragma 排除是把代码本身踢出统计——一个管「值域怎么算」,一个管「代码算不算」,详见 bins illegal 与 ignore。项目收尾时两类排除要合并进同一张签出表:代码侧列 pragma 与外部排除文件,功能侧列 ignore_bins 清单,评审一起过。只审一侧的签出是不完整的——曾经见过代码覆盖率 99% 漂亮的项目,功能覆盖率里三分之一的 cross 被 ignore 掉,实际验证完备性远不达标。两类排除共用同一套纪律:有理由、最小化、可审计、参数变更复检。
这一篇在知识体系里的位置
本篇是 chip-design/verification 目录的一篇 L 层速查,主关键词覆盖率排除 pragma。它向上承接 代码与功能覆盖率 的统计口径与 覆盖率合并与排除流程 的治理框架;横向与 bins illegal 与 ignore(功能覆盖率侧的排除语义)、lint waiver 签出(另一套豁免纪律)同构;审计结论汇入 验证签出。
总结
覆盖率排除 pragma 的要点就四句:coverage off/on 只踢覆盖率统计、translate_off 只踢综合,两者正交不可互替;跨工具 RTL 用 // pragma coverage off/on 最可移植,厂商前缀写法换工具要全量清查;结构性不可达走内联 pragma、项目级豁免走外部排除文件;每处排除必须带理由、范围最小化、签出前全量清点——排除管的是分母,掩盖不了真 bug。