vscode 运行 verilog 依赖系统命令，必须确保 iverilog、vvp、gtkwave 在集成终端中可用且路径配置正确，tasks.json 中 command 和 args 需分离，testbench 需含 $dumpfile/$dumpvars 才能生成并打开波形。
终端里跑不通 iverilog，VSCode 就不可能跑起来
VSCode 本身不执行 Verilog，它只调用系统命令。F5 没反应、任务失败、波形打不开，90% 是因为 iverilog、vvp、gtkwave 这三个命令在 VSCode 集成终端（Ctrl+`）里根本不可用。
必须手动验证：
- 打开 VSCode 集成终端，逐行执行：
iverilog -v、vvp -v、gtkwave --version - 三者都必须立即输出版本号，不能报
'iverilog' is not recognized或command not found - Windows 用户重装过
iverilog后，务必勾选 “Add to system PATH”，且必须完全退出 VSCode 再重启，否则环境变量不加载 - macOS/Linux 用户用
which iverilog确认路径；若为空或指向错误位置，用brew reinstall icarus-verilog或sudo apt install iverilog gtkwave重装
tasks.json 里 command 和 args 必须分开写
VSCode 的 task 不支持把命令和参数拼成字符串。写成一行会静默失败——它会去找一个叫 "iverilog -o top top.v" 的可执行文件，而不是运行 iverilog 并传参。
正确写法（以编译为例）：
{
"command": "iverilog",
"args": ["-o", "${fileBasenameNoExtension}", "${file}"]
}
常见错误写法（直接失效）：
{"command": "iverilog -o ${fileBasenameNoExtension} ${file}"}
仿真阶段必须用 vvp 执行生成的二进制文件，不能跳过这步：
-
"command": "vvp"+"args": ["${fileBasenameNoExtension}"] - 如果 testbench 里写了
$dumpfile("wave.vcd"); $dumpvars;，才能用gtkwave自动打开波形："command": "gtkwave"+"args": ["wave.vcd"]
verilog.linterPath 填的是可执行文件全路径，不是目录
插件报 “linter not found”，不是插件坏了，而是它压根找不到 iverilog 或 verilator 这个程序。
VSCode 设置中 verilog.linterPath 必须填完整路径，例如：
- Windows：
C:\iverilog\bin\iverilog.exe（不是C:\iverilog\bin\） - macOS：
/opt/homebrew/bin/iverilog - Linux：
/usr/bin/iverilog
填错等于没配。路径中含空格或中文字符时，极大概率触发解析失败，建议全程使用纯英文无空格路径。
GTKWave 波形打不开？先确认 testbench 是否生成了 .vcd
gtkwave wave.vcd 失败，往往不是 GTKWave 问题，而是 wave.vcd 根本没生成。
检查你的 testbench 是否包含这两行（且未被注释）：
$dumpfile("wave.vcd");$dumpvars;
注意：
- 文件名必须严格一致，
gtkwave调用的args里写的什么名，$dumpfile就得写什么名 -
$dumpvars默认 dump 全局模块；如需指定层级，写成$dumpvars(0, top);（假设顶层模块叫top） - 仿真前确保当前工作目录是
.v文件所在目录，否则vvp可能找不到生成的二进制
工具链之间没有魔法，只有命令是否真正连通。最容易被忽略的，是每次改完 tasks.json 或环境变量后，忘了关掉 VSCode 再开——那一切配置都只是纸上谈兵。
