vscode本身不能运行verilog代码，它只是编辑器；真正执行编译、仿真与波形查看的是iverilog、vvp和gtkwave组成的工具链，必须通过tasks.json配置任务串联三步流程，并确保testbench含正确$dumpfile/$dumpvars语句及路径无空格。
VSCode 本身不能运行 Verilog 代码，它只是编辑器；真正执行仿真的是 iverilog + vvp + gtkwave 这套工具链。你点 F5 没反应、报 Cannot find a program to debug，不是插件没装对，而是根本没定义“怎么跑”。
为什么 tasks.json 是唯一靠谱的入口
插件的“一键运行”按钮大多只调 iverilog 编译，不启动 vvp，更不会开 gtkwave。只有 tasks.json 能把三步串起来，且支持错误跳转、变量替换和任务分组。
-
command字段必须是可执行文件名（如"iverilog"），不能带参数；参数全得塞进args数组里 - 写成
"command": "iverilog -o tb.vvp tb.v"会静默失败——VSCode 会去找一个叫这个整串名字的程序 - 必须用
${file}和${fileBasenameNoExtension}这类变量，否则无法适配不同文件名 - 每个 task 最好只做一件事：编译、仿真、看波形——混在一起失败时难定位
testbench 里漏写 $dumpfile 就永远看不到波形
iverilog 编译通过、vvp 也跑完了，但 gtkwave 打开是空的？大概率是 testbench 里没写或写错了波形导出语句。
- 必须有
$dumpfile("wave.vcd");—— 文件名要和gtkwave任务里调用的一致 - 必须有
$dumpvars(0, top);（或对应顶层模块名），否则只生成空壳.vcd - 这两行得放在
initial块里，且在$finish之前 - 如果用
SystemVerilog，$dumpvars参数可简化为$dumpvars(1, dut);，但iverilog对 SV 支持有限，建议先用纯 Verilog 验证流程
Windows 下 gtkwave 路径含空格就崩
装完 gtkwave，tasks.json 里写 "command": "C:\Program Files\GTKWave\bin\gtkwave.exe"，VSCode 会卡住不动——因为路径里有空格，命令解析失败。
- 正确做法是把整个路径用双引号包住：
"command": "C:\Program Files\GTKWave\bin\gtkwave.exe"不行，得写成"command": ""C:\Program Files\GTKWave\bin\gtkwave.exe"" - 更稳妥的方式是用
where gtkwave查到实际路径（比如C:msys64ucrt64ingtkwave.exe），选一个无空格的安装位置 - 别信某些教程说“改注册表绕过”，新版 VSCode 对参数解析更严格，路径格式错一点就静默失败
verilog.linterPath 配错 = 白装插件
语法高亮失效、悬停没提示、按 F12 跳不到模块定义？90% 是 verilog.linterPath 没设对，而不是插件没装。
- 设置项名是
verilog.linterPath（带Path），不是verilog.linter（那是开关） - Windows 上运行
Get-Command verilator | Select-Object -ExpandProperty Path，复制完整路径（含.exe）粘贴进去 - Linux/macOS 运行
which verilator，结果直接填入，不要删后缀 - 填完重启 VSCode，再在集成终端里敲
verilator --version验证——这步跳过，后面所有 linting 都不会动
tasks.json 和 verilog.linterPath 这两个地方，一个控制“能不能跑起来”，一个控制“写的时候知不知道错了”。两者都得亲手验证，不能只靠插件图标绿了就以为通了。
