iverilog必须加入系统PATH，否则VSCode任务和终端无法识别命令；ctags需用universal-ctags并正确配置路径；tasks.json中避免通配符误编译；$dumpfile和$dumpvars路径与层级须精准匹配。
为什么 iverilog 必须加到系统 PATH 才能用 VSCode 一键仿真
VSCode 的终端和任务（tasks.json）默认继承系统环境变量，但不会自动读取安装时未勾选的 PATH 条目。如果安装 iverilog 时没勾选 “Add to system PATH”，你在命令行手动打开 PowerShell 或 CMD 可能也找不到 iverilog 命令——更别说让 VSCode 调用了。
常见现象：tasks.json 中执行 iverilog -o ... 报错 'iverilog' is not recognized as an internal or external command，或者 Code Runner 插件点击运行直接无响应。
- Windows 用户：重装
iverilog，务必勾选 “Add to system PATH”；若已装过，可手动把安装目录（如C:\Program Files\Icarus Verilog\bin）加进系统环境变量 PATH - macOS/Linux 用户：用
brew install icarus-verilog或apt install iverilog安装后，PATH 通常已自动配置；验证方式是终端输入which iverilog，应返回有效路径 - VSCode 启动前必须确保 PATH 已生效——关掉所有 VSCode 窗口，再从开始菜单或 Dock 重新启动，否则旧进程仍用旧环境变量
Verilog-HDL 插件依赖 ctags，不配就等于没跳转功能
这个插件标榜“支持定义跳转”“悬停提示信号位宽”，但底层靠的是外部 ctags 工具生成标签文件。不装、不配、不重启，Ctrl+鼠标左键点模块名只会光标闪烁，啥也不发生。
容易被忽略的细节：
- 必须用
universal-ctags（不是老版 exuberant-ctags），后者不支持 Verilog 的module、parameter等关键语法解析 - Windows 下下载
ctags.exe后，不能只放桌面或随便一个文件夹；需在插件设置里显式填入完整路径，例如C:\tools\ctags.exe - 首次启用后，要右键项目根目录 → “Verilog: Generate Tags”，或手动在终端运行
ctags -R --language-force=verilog -f .tags ./src - 如果跳转仍失败，检查
.tags文件是否生成、是否在工作区根目录下——插件默认只认这个名字和位置
tasks.json 编译命令写成 iverilog -o ${workspaceFolder}/sim/output.vvp ${fileDirname}/*.v 是危险操作
这条命令看着方便，实际会把整个 src/ 目录下所有 .v 文件一股脑编译进去，包括你还没写完的模块、废弃的旧版本、甚至 tb/ 里的测试平台——结果是编译报错、信号连错、波形空空如也。
真正可控的做法是限定范围：
- 改用显式文件列表：
iverilog -o ${workspaceFolder}/sim/output.vvp ${file} ${fileDirname}/../src/top_module.v ${fileDirname}/../src/sub_module.v - 或按目录隔离：把设计源码统一放在
/src，测试平台放/tb，然后命令写成iverilog -o ${workspaceFolder}/sim/output.vvp -s tb_${fileBasenameNoExtension} ${workspaceFolder}/src/*.v ${file}，其中-s指定顶层模块名 - 避免通配符
*.v在大型工程中使用——它不区分include文件、config 文件或自动生成的 stub，极易引入冲突
GTKWave 波形打不开？关键在 $dumpfile 和 $dumpvars 的路径与层级
VSCode 里点了仿真，vvp 运行成功，但双击 wave.vcd 打开 GTKWave 却一片空白——大概率是 $dumpvars 参数设错了，或者 dump 文件路径没对上。
实操要点：
-
$dumpfile("wave.vcd")中的路径是相对仿真运行目录（即vvp所在目录）的，不是相对于 testbench 文件的。建议统一用绝对路径：$dumpfile("${workspaceFolder}/sim/wave.vcd") -
$dumpvars(0, tb_example)的第二个参数必须是 testbench 实例名，且层级要完整。如果 testbench 名叫tb_top，里面例化了uut，那应该写$dumpvars(0, tb_top)，而不是$dumpvars(0, uut)——后者只 dump DUT 内部，不包含 testbench 生成的 clk/rst - GTKWave 启动后默认不展开信号树。右键左侧信号列表 → “Expand All” 或手动点三角展开，才能看到具体信号
- VSCode 中可配合
Waveform Viewer插件，但它只是调起 GTKWave；真正决定波形内容的，永远是 testbench 里那两行$dump*语句
最常被绕过去的点：ctags 路径配错、$dumpvars 层级写漏、tasks.json 用通配符误编译——这三处一出问题，整个流程就卡在“看起来跑通了，其实没效果”的状态，比报错还难排查。
