Sublime Text 配置VHDL需三步：右下角设“Open all with current extension as→VHDL”，用户设置中添加{"extensions": {"vhd": "source.vhdl", "vhdl": "source.vhdl"}}，并选用支持source.vhdl作用域的配色方案（如Material Theme）。
Sublime Text 本身不识别 .vhd 文件，装完插件 ≠ 能高亮、能编译、能跳错误——最常卡在右下角显示 Plain Text 这一步。
右下角还是 Plain Text？语法绑定没生效
这是 VHDL 配置失败的头号信号。即使你已安装插件、重启过 Sublime，只要状态栏没显示 VHDL，后续所有功能（高亮、缩进、括号匹配）全失效。
- 点击右下角
Plain Text→ 选Open all with current extension as…→VHDL（不是Set Syntax → VHDL，后者只对当前文件临时生效） - 打开
Preferences → Settings – User，确认存在这行映射（缺一不可）：{"extensions": {"vhd": "source.vhdl", "vhdl": "source.vhdl"}} -
.vhd是 FPGA 工程主流后缀，但很多插件默认只绑.vhdl；漏配"vhd": "source.vhdl"就等于白装 - 改完保存，重新打开一个
.vhd文件验证：输入signal或begin，立刻看到变色才说明成功
关键词全灰？主题不认 source.vhdl 作用域
状态栏显示 VHDL、Ctrl+Shift+P 输入 Inspect Scope 也能看到 source.vhdl，但 entity、port 还是灰色——问题不在语法识别，而在配色方案没定义对应语义。
- 临时验证：菜单
Preferences → Color Scheme → Monokai，如果着色恢复，就是当前主题缺失规则 - 轻量或自定义主题（尤其
.sublime-color-scheme文件）常忽略keyword.control.vhdl、support.type.vhdl等 scope - 推荐开箱即用的主题：
Material Theme + Adaptive或Ayu Mirage，它们对 VHDL 关键词覆盖较全
Ctrl+B 编译报 command not found？PATH 或路径转义没兜住
高亮只是第一步，构建系统调用 vcom 或 ghdl 失败，90% 是环境变量或路径含空格/中文导致的。
- 先在终端验证：
vcom -version或ghdl --version能返回版本，说明 PATH 正确；若不行，得把工具路径加进系统环境变量 - Windows 下从开始菜单启动 Sublime 时，经常读不到用户级 PATH —— 改用命令行启动：
subl.exe（需确保已加到 PATH） -
.vhd文件路径含空格（如C:My FPGA Project op.vhd）时，$file变量必须加引号："cmd": ["cmd.exe", "/c", "ghdl -a "${file}""] - Linux/macOS 更稳妥写法：
"cmd": ["sh", "-c", "ghdl -a "$1"", "_", "$file"]
，靠 shell 层自动转义
构建后错误点不了跳转？file_regex 没匹配 GHDL 报错格式
输出面板里一堆红字，但点不了错误行——说明 file_regex 没对上实际报错结构，Sublime 根本解析不出文件名和行号。
- GHDL 典型报错格式是：
adder.vhd:12:17: unknown identifier "cin" - 对应正则必须严格匹配：
"file_regex": "^(.+?):([0-9]+):([0-9]+):? ?(.*)$"
（注意冒号、空格、分组顺序） - Windows 路径带盘符（
C:），正则得兼容冒号：^([a-zA-Z]:)?[/\\](.+?):([0-9]+):([0-9]+):?，否则解析失败 - 别直接抄网上的通用正则，先用
ghdl -a xxx.vhd在终端跑一次，看真实报错长什么样，再反推正则
真正麻烦的从来不是写配置，而是某次插件升级、Sublime 重装，或者误删一行 JSON，就让 source.vhdl 作用域静默消失——此时状态栏还显示 VHDL，但高亮全无，很难第一时间定位到是用户设置里那行 extensions 映射丢了。
