VSCode本身不运行Verilog，仅调用iverilog编译、vvp仿真、gtkwave查看波形；失败主因是工具未入PATH、verilog.linterPath未指向可执行文件、tasks.json中command与args未分离、testbench缺少$dumpfile/$dumpvars。
VSCode 本身不运行 Verilog，它只调用外部工具链；配置失败的主因是命令不可达、路径没对上、或波形生成环节断开。
verilog.linterPath 配错导致语法高亮失效
插件显示“linter not found”不是因为插件没装，而是 verilog.linterPath 没填对——这个设置项必须指向可执行文件（如 verilator.exe 或 iverilog），不是目录，也不是开关 verilog.linter。
- Linux/macOS：运行
which verilator或which iverilog，把输出完整路径（如/usr/local/bin/verilator）粘贴进设置 - Windows：在 PowerShell 中运行
Get-Command verilator | Select-Object -ExpandProperty Path，复制带.exe的全路径（如C:\tools\verilator\bin\verilator.exe） - 验证方式：在 VSCode 集成终端中直接运行
verilator --version或iverilog -v，有版本输出才算通 - 重启 VSCode：改完设置后必须完全关闭再重开，否则旧进程仍用旧环境变量
tasks.json 中 command 和 args 必须分离
VSCode 的 tasks.json 不接受拼接命令字符串；写成一行会静默失败，比如 "command": "iverilog -o sim.vvp testbench.v" 实际是在找一个叫这个名字的程序。
- 正确写法：
"command": "iverilog"+"args": ["-o", "sim.vvp", "testbench.v"] - 仿真必须分两步：先用
iverilog编译出.vvp文件，再用vvp执行它（vvp通常随iverilog一起安装） - 波形查看依赖
$dumpfile("wave.vcd")和$dumpvars在 testbench 里显式调用，缺一不可 - 如果用
gtkwave打开波形，路径含空格（如C:\Program Files\GTKWave\bin\gtkwave.exe）必须用引号包裹，否则启动失败
ctags 路径和生成方式不对，跳转/补全就失效
Verilog-HDL 插件的模块跳转、信号补全完全依赖 ctags 生成的 .tags 文件；不装 universal-ctags、不指定路径、不手动触发，功能等于关闭。
- 必须用
universal-ctags（非老版 exuberant-ctags），Windows 下下载后得到的是ctags.exe，路径要精确到该文件（如C:\tools\ctags\ctags.exe） - 首次配置后需右键项目根目录 → “Verilog: Generate Tags”，或终端运行：
ctags -R --fields=+nia --c-kinds=+p --file-scope=yes --langmap=verilog:.v.sv . - 若项目有子目录（如
src/、tb/），建议在根目录下手动跑一次ctags，避免插件扫描遗漏 -
.tags文件必须位于 VSCode 工作区根目录，且名字不能改；插件默认只认这个路径和文件名
iverilog 和 gtkwave 命令在终端里跑不通，tasks 就一定失败
VSCode 的任务系统继承终端环境变量，但不会自动修复 PATH；你能在外部终端运行，不代表 VSCode 终端也能——尤其 Windows 用户常忽略安装时是否勾选了 “Add to PATH”。
- Windows：重装
iverilog时务必勾选 “Add to system PATH”；若已装过，手动把bin目录（如C:\iverilog\bin）加进系统环境变量，并重启 VSCode - macOS/Linux：用
brew install icarus-verilog或apt install iverilog后，检查which iverilog输出是否在标准 PATH 下；否则需调整 shell 配置文件（如~/.zshrc）并重新加载 - gtkwave 同理：终端输入
gtkwave --version必须有响应；没有就说明没装或 PATH 没生效 - 别信插件的“一键运行”按钮——它往往只做编译，不启动
vvp和gtkwave，真正可控的只有自己写的tasks.json
最易被忽略的是：testbench 里 $dumpfile 和 $dumpvars 的调用位置、层级、参数是否匹配实际模块结构；哪怕只漏掉一个 $dumpvars(0, top)，波形文件就是空的，而错误不会报在终端里。
