VSCode本身不能运行VHDL，必须依赖ghdl完成分析（-a）、绑定（-e）、执行（-r）三步，并用gtkwave打开wave.vcd波形文件；配置需验证ghdl安装、分步定义tasks.json任务、添加problemMatcher支持错误跳转，且testbench须显式启用VCD输出。
VSCode 本身不能运行 VHDL，必须靠 ghdl 完成分析（-a）、绑定（-e）、执行（-r）三步，再用 gtkwave 打开生成的 wave.vcd —— 配错任一环节，都会卡在“没输出”或“command not found”上。
确认 ghdl 已安装且终端可用
这是整个流程的地基。VSCode 的任务系统不自动继承 GUI 启动时的 PATH，所以先得在终端里验证：
- 打开 VSCode 集成终端（
Ctrl+`），运行ghdl --version；有版本号输出才算通过 - 若报
command not found，macOS 用户执行brew install ghdl，Ubuntu 执行sudo apt install ghdl，Windows 建议用 MSYS2 安装或下载 prebuilt 版 - macOS Apple Silicon 默认路径是
/opt/homebrew/bin/ghdl，Intel 是/usr/local/bin/ghdl；Windows 若未加进系统 PATH，后续 tasks.json 里就得写绝对路径 - 装完别忘了重启 VSCode —— 很多人跳过这步，导致扩展和 task 都读不到
ghdl
用 tasks.json 分步定义 ghdl 任务
把三步拆成独立 task，比塞进一个 shell 命令更易调试、错误定位更准。关键不是“能跑”，而是“出错能跳转到源码行”：
- 在项目根目录建
.vscode/tasks.json，至少包含三个 label："GHDL Analyze"、"GHDL Elaborate"、"GHDL Run" - 每个 task 的
"type"必须是"shell"（不是"process"），否则参数解析会错乱 -
"problemMatcher": ["$ghdl"]必须加——没有它，报错只在终端滚屏，双击不会跳转到top.vhd:12:17这类位置 - 推荐写法：
"args": ["-a", "--std=08", "${file}"]（显式指定 VHDL-2008 标准，避免默认 93 导致语法误报）"args": ["-e", "${fileBasenameNoExtension}"]"args": ["-r", "--vcd=wave.vcd", "${fileBasenameNoExtension}"] - 不要把
-a && -e && -r写在一个 task 里：某步失败时你不知道卡在哪，且$ghdlmatcher 只匹配单条命令输出格式
手动触发 gtkwave 查看波形
ghdl -r 只生成文本格式的 wave.vcd，它不弹窗、不绘图。VSCode 不自动打开波形，必须自己配 task 调起外部工具：
- 先确保已安装
gtkwave：macOS 执行brew install gtkwave，Ubuntu 执行sudo apt install gtkwave，Windows 下注意路径含空格（如C:\Program Files\GTKWave\gtkwave.exe）需用引号包裹 - 在
tasks.json中新增一个 task，"command": "gtkwave"，"args": ["wave.vcd"]，并设"group": "build"方便归类 - 必须按顺序触发：
GHDL Analyze → GHDL Elaborate → GHDL Run → GTKWave；VSCode 不自动等待前序 task 完成，也不会检查wave.vcd是否存在就直接调用 - 常见失败现象：
gtkwave: command not found（没装或没进 PATH）、Cannot open file 'wave.vcd'（ghdl -r没成功执行，或仿真代码里没加write或dump相关语句）
别让插件互相打架：vhdllint 和 teros_hdl 不能共存
有些用户装了多个 VHDL 插件后发现 linting 失效、语言模式错乱、甚至 tasks.json 被静默忽略——根本原因是插件冲突：
-
teros_hdl自带仿真任务模板和工程管理逻辑，但会覆盖vhdllint的语法检查行为，且它依赖vlib work，而现代ghdl默认不用库（--no-vpi模式下更干净） - 如果你只做 RTL 仿真，推荐用
VHDL Language Server（sameer83）或VHDL（vijayv500） + 纯ghdltask 组合；禁用teros_hdl可避免vlib work failed类报错 - 检查方法：禁用所有 VHDL 插件，逐个启用并观察右下角语言模式是否稳定显示为
VHDL，以及PROBLEMS面板是否实时更新 - 额外提醒：
vhdl.linterPath设置项只对vhdllint有效；若你用的是ghdl做 linting，实际走的是ghdl -a流程，设置里填的是vhdl.ghdl.path
最常被忽略的一点：VHDL 仿真必须有可执行的 testbench，且其中要显式调用 std.textio.write 或使用 ghdl 的 VCD dump 机制；光写个 entity + architecture 不会自动生成 wave.vcd，ghdl -r 也就只是空跑一次。
