VSCode本身不运行Verilog，需通过tasks.json调用iverilog编译、vvp仿真、gtkwave查看波形；F5失败主因是工具未加入PATH或tasks参数错误，三者命令必须在终端直连可用。
VSCode 本身不运行 Verilog，它只负责调用外部工具链；按 F5 没反应、点击“运行”失败、波形打不开，90% 是因为 iverilog、vvp、gtkwave 这三个命令没在终端里直接可用，或 tasks.json 里参数写错位置。
验证终端能否真正调用仿真工具
这是所有配置的前提。VSCode 的集成终端（Ctrl+`）必须能原样执行这些命令，否则 tasks、插件、快捷键全失效。
-
iverilog -v要立即输出版本号（如Icarus Verilog version 12.0），不能报'iverilog' is not recognized -
vvp -v和gtkwave --version同理——三者缺一不可 - Windows 用户若重装过
iverilog，务必勾选 “Add to system PATH”；手动添加后，**必须完全关闭 VSCode 再重启**，否则环境变量不加载 - macOS/Linux 用户用
which iverilog确认路径，如果返回空或指向错误位置，用brew reinstall icarus-verilog或sudo apt install iverilog重装
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}"] - 若要自动打开波形，最后一段得调
gtkwave："command": "gtkwave"+"args": ["wave.vcd"]，前提是 testbench 里写了$dumpfile("wave.vcd"); $dumpvars;
verilog.linterPath 填的是可执行文件全路径，不是目录
插件显示 “linter not found”，不是插件坏了，而是它根本找不到 verilator 或 iverilog 这个程序。填错路径等于没配。
- Linux/macOS：运行
which verilator，把输出（如/usr/local/bin/verilator）完整粘贴进设置项verilog.linterPath - Windows：用 PowerShell 运行
Get-Command verilator | Select-Object -ExpandProperty Path，结果类似C:\tools\verilator\bin\verilator.exe，**必须带 .exe 后缀** - 别填
C:\tools\verilator\bin这种目录——插件不会自己拼verilator.exe - 设置项名是
verilog.linterPath，不是verilog.linter（后者只是开关）
ctags 跳转失效？大概率没装 universal-ctags 或路径不对
Verilog-HDL 插件的 Ctrl+单击跳转、悬停看端口、补全信号名，全靠 ctags 生成的 .tags 文件。不生成或路径错，就只剩语法高亮。
- 必须用
universal-ctags（官网下载），老版exuberant-ctags不支持module、logic等语法 - Windows 下填设置项
verilog.ctagsPath时，必须是C:\tools\ctags.exe这种完整可执行路径，不能是文件夹 - 首次配置后，右键项目根目录 → “Verilog: Generate Tags”，或终端运行：
ctags -R --fields=+nia --c-kinds=+p --file-scope=yes --langmap=verilog:.v.sv . - 生成的
.tags文件必须在工作区根目录下，插件默认只读这个位置
最容易被忽略的一点：testbench 里 $dumpfile 和 $dumpvars 的调用顺序和层级必须匹配——$dumpvars 要在 initial 块里，且不能放在 fork/join 内部；生成的 .vcd 文件路径要是相对当前工作目录的，否则 gtkwave 找不到。
