必须手动将.vhd扩展名映射到source.vhdl作用域，否则即使安装vhdl插件，文件仍显示plain text、无语法高亮；需通过右下角绑定并配置settings–user中{"extensions": {"vhd": "source.vhdl", "vhdl": "source.vhdl"}}。
装完VHDL插件后右下角仍显示Plain Text，说明语法绑定根本没生效——这不是插件装错了，而是.vhd扩展名没被映射到source.vhdl作用域。
点击右下角Plain Text手动绑定.vhd文件类型
这是最常卡住的一步：Sublime默认完全不识别.vhd后缀，哪怕插件已安装，打开文件仍是灰字、无括号匹配、无缩进。必须主动干预：
- 打开任意
.vhd文件，看右下角状态栏是否为Plain Text - 点击那里，选
Open all with current extension as…→VHDL（注意不是Set Syntax → VHDL，后者只对当前文件临时生效） - 操作后，新打开的
.vhd文件会自动应用VHDL语法，输入entity或begin应立刻变色
在Preferences → Settings – User中补全扩展名映射
仅靠右下角点击不够稳定。插件升级、重装Sublime或误改配置都可能让映射丢失，导致高亮“突然失效”——表面显示VHDL，实际source.vhdl作用域未触发。
- 打开
Preferences → Settings – User - 确认存在这行配置：
{"extensions": {"vhd": "source.vhdl", "vhdl": "source.vhdl"}} - 若没有，直接粘贴进去；若已有但只写了
"vhdl"，务必补上"vhd"——FPGA工程几乎全用.vhd，漏掉这一项等于白装 - 保存后重启Sublime或重新打开
.vhd文件验证
避免装错冷门VHDL插件导致Unable to load syntax file
社区里有多个名字相似的VHDL包，但只有少数适配Sublime Text 4。装错会导致语法文件加载失败，甚至让整个语法系统异常。
- 打开命令面板（
Ctrl+Shift+P），输入Package Control: Install Package - 搜索关键词
VHDL，只选官方维护、更新活跃的那一个（通常作者是sublimehq或知名硬件开发维护者） - 坚决避开
VHDL Syntax、VHDL-Mode等长期未更新的分支——它们不兼容ST4，容易报Unable to load syntax file - 装完后检查插件目录：
Packages/VHDL/下应有syntaxes/VHDL.sublime-syntax，且内容含scope: source.vhdl
高亮生效但颜色不对？检查配色方案是否支持source.vhdl作用域
有些主题（如Monokai、Default）只定义了主流语言的作用域，对source.vhdl无样式规则，结果关键字仍是灰色——不是插件问题，是主题不兼容。
- 换用明确声明支持硬件语言的主题，例如
Material Theme或Neon Color Scheme - 在主题配置中确认是否包含针对
source.vhdl的keyword、string、comment等作用域定义 - 临时验证：打开
Preferences → Color Scheme，切换几个不同主题，观察signal、port等词颜色是否变化
真正卡住人的从来不是插件装不装得上，而是.vhd后缀和source.vhdl之间的那一层映射——它既不在插件里自动完成，也不随Sublime启动而持久，必须手动钉死在用户设置里，且每次环境变动都要再核对一遍。
