VSCode本身不运行VHDL，需依赖GHDL等外部工具链实现编译、仿真与波形查看；必须配置tasks.json定义分析（ghdl -a）、绑定（ghdl -e）和运行（ghdl -r）任务，并集成gtkwave查看VCD波形，同时vhdllint与TEROS_HDL插件不可共存。
VSCode 本身不运行 VHDL，得靠外部工具链
VSCode 是编辑器，不是仿真器。它不能直接“运行”VHDL 文件，必须调用 ghdl（推荐）或 modelsim 这类命令行仿真工具来编译、执行、生成波形。如果你双击一个 .vhdl 文件只看到语法高亮，没报错也没输出——这完全正常，说明 VSCode 正确识别了语言，但还没连上仿真后端。
关键判断点：打开终端，输入 ghdl --version 能返回版本号，才代表工具链就位；否则所有配置都是空转。
- Windows 用户建议用
ghdl（msys2 或 prebuilt 版），比 ModelSim 安装轻、启动快、无许可证烦恼 - macOS 用户用
brew install ghdl最稳，避免手动编译的路径权限问题 - Linux 用户优先从源码编译（
./configure --prefix=/usr/local），能启用--enable-synth支持综合流程
必须配 tasks.json 才能一键编译 VHDL
VSCode 的“运行”动作本质是执行预定义任务。不手动建 .vscode/tasks.json，右键菜单里就不会出现“Run Task”选项，更别提自动编译。
示例最小可用配置（存为项目根目录下的 .vscode/tasks.json）：
{
"version": "2.0.0",
"tasks": [
{
"label": "GHDL Analyze",
"type": "shell",
"command": "ghdl -a --std=08 ${file}",
"group": "build",
"presentation": { "echo": true, "reveal": "always", "focus": false },
"problemMatcher": [ "$ghdl" ]
}
]
}
-
${file}是当前打开的 VHDL 文件，不是工程顶层；多文件工程需改用ghdl -a --std=08 *.vhdl -
--std=08显式指定 VHDL-2008 标准，避免老版本默认用 93 标准导致语法报错 -
problemMatcher启用后，错误会出现在“PROBLEMS”面板，点击可跳转到具体行
仿真+波形查看要两步走，缺一不可
只做语法分析（ghdl -a）不算“运行”，真正看到信号波形必须完成：编译（analyze）→ 绑定（elaborate）→ 运行（run）。VSCode 默认不触发后两步，必须补全任务链或用终端手动敲。
- 绑定命令是
ghdl -e --std=08 ${fileBasenameNoExtension}，注意参数是实体名，不是文件名 - 运行命令是
ghdl -r --std=08 ${fileBasenameNoExtension} --vcd=${fileBasenameNoExtension}.vcd，生成 VCD 波形文件 - 波形查看依赖
gtkwave：任务末尾加&& gtkwave ${fileBasenameNoExtension}.vcd可自动唤起，但 macOS/Linux 需确保gtkwave在$PATH中
常见卡点：Windows 上 gtkwave 路径含空格（如 C:\Program Files\...）会导致命令失败，必须用引号包裹或改用短路径（PROGRA~1）。
插件不是万能的，vhdllint 和 TEROS_HDL 选一个就行
VSCode 插件市场里搜 “VHDL”，会跳出十几个结果。但真正稳定可用的只有两类：
-
vhdllint：纯静态检查，依赖 Python +vhdllint包，报错准、启动快，适合写代码时实时提示拼写/端口不匹配 -
TEROS_HDL：功能重，支持跳转、补全、ModelSim 集成，但必须严格配对modelsim.installationPath和workPath，稍错就报(vlog-66)
二者不可共存——TEROS_HDL 会覆盖 vhdllint 的 linting 设置，且同时启用会导致诊断重复、CPU 占用飙升。新手建议从 vhdllint 入手，等熟悉后再切 TEROS。
最易被忽略的一点：vhdllint 不检查语法是否符合综合要求（比如异步复位写法），它只管“能不能被解析”。真要验证可综合性，必须跑 ghdl --synth 或进 Vivado/Quartus 做 RTL 分析。
