VSCode中VHDL-Tool插件配置与硬件描述语言语法高亮-VSCode-PHP中文网

vhdl-tool插件已停止维护，2026年起在vscode 1.85+及新系统下普遍崩溃；应卸载该插件，改用vhdl language server（sameer83）+ghdl组合，并配置files.associations强制关联.vhd与.vhdl文件。

vscode中vhdl-tool插件配置与硬件描述语言语法高亮

VHDL-Tool 插件在 VSCode 中已停止维护，2026 年起无法正常工作，不建议配置或依赖它。 它的语法高亮、补全和 LSP 功能在 VSCode 1.85+ 和 macOS Sequoia / Windows 11 22H2+ 环境下普遍崩溃，且作者自 2024 年底起未发布更新。你现在看到的“高亮失效”“跳转报错”“右键无 Run Task”，大概率不是配错了，而是插件本身已不可用。

为什么 VHDL-Tool 会静默失败

它依赖一个已下线的私有语言服务器二进制 vhdl-tool-server，该服务在 2025 年中旬被作者从 GitHub Releases 移除；VSCode 启动时尝试下载失败，但不报错，只让状态栏显示“VHDL Tool: initializing…”并长期卡住；即使你手动放了个旧版二进制进去，它也无法兼容新版 GHDL（≥4.1）的 AST 输出格式，导致端口解析错误、entity 与 architecture 匹配失败。

常见现象包括：

打开 .vhd 文件后，右下角语言模式仍显示 Plain Text 或 Text
按 Ctrl+Click 跳转到 component 声明时提示 “No definition found”
保存后无任何报错，哪怕写 signal a : std_logic_vector(8 downto 0);（位宽非法）也沉默
终端运行 ghdl --version 正常，但 VSCode 里 Problems 面板始终为空

替代方案：用 VHDL Language Server + GHDL 组合

这是目前唯一在 macOS / Linux / Windows 上全平台稳定、持续更新的组合（截至 2026 年 8 月）。它不依赖私有二进制，直接调用系统已安装的 ghdl 进行语义分析。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

实操要点：

卸载所有名称含 VHDL-Tool 的扩展，重启 VSCode
安装 VHDL Language Server（作者 sameer83），不是 VHDL（vijayv500）——后者仅提供基础高亮，无 LSP
确保 ghdl 已安装且在 PATH 中：ghdl --version 必须返回 GHDL 4.1.0+

在 settings.json 中添加：

{
  "vhdl.enableLanguageServer": true,
  "vhdl.linter": "ghdl",
  "vhdl.ghdl.path": "/opt/homebrew/bin/ghdl",
  "vhdl.lintOnType": true
}

必须在项目根目录放一个 ghdl.json（哪怕空内容），否则服务器拒绝启动

语法高亮不准？先确认语言模式再调主题

高亮异常 90% 不是主题问题，而是 VSCode 根本没把文件当 VHDL 解析——这会导致 token scope 全错，后续所有颜色规则都无效。

检查步骤：

打开任意 .vhd 文件，看右下角状态栏：如果不是 VHDL，点击它 → Configure File Association for '.vhd' → 选 VHDL
更彻底的方法：在 settings.json 加强制映射："files.associations": {"*.vhd": "vhdl"}
验证 scope 是否正确：光标停在 process 上，按 Ctrl+Shift+P → 输入 Developer: Inspect Editor Tokens，输出中应含 keyword.control.vhdl，不是 keyword 或 source.verilog
只有确认 scope 正确后，才去改 editor.tokenColorCustomizations，例如加粗 entity：{"scope": ["keyword.declaration.entity.vhdl"], "settings": {"fontStyle": "bold"}}

真正容易被忽略的是：VHDL Language Server 默认不处理 .vhdl 扩展名，哪怕你关联了也不行。必须在 settings.json 显式加一行："files.associations": {"*.vhdl": "vhdl"}，两个扩展名都要覆盖。否则新建的 top.vhdl 会永远灰白一片，连括号匹配都没有。