右下角显示 plain text 即 vhdl 高亮完全失效；必须点击该处→选 open all with current extension as…→vhdl，并在 settings–user 中确认含 {"extensions": {"vhd": "source.vhdl", "vhdl": "source.vhdl"}}，保存后重启，新建 test.vhd 输入 signal 或 begin 验证变色。
右下角显示 Plain Text 就等于 VHDL 高亮完全失效
打开 top.vhd 文件，右下角状态栏必须显示 VHDL，不是 Plain Text。90% 的配置失败卡在这一步——插件装了、文件名对了，但 Sublime 根本没加载语法定义。
- 点击右下角
Plain Text→ 选Open all with current extension as…→VHDL（注意：不是Set Syntax → VHDL，后者只临时生效） - 打开
Preferences → Settings – User，确认存在这一行：{"extensions": {"vhd": "source.vhdl", "vhdl": "source.vhdl"}} - 保存后重启 Sublime；新建
test.vhd，输入signal或begin看是否变色——没变色说明映射没生效
构建系统必须显式启用 shell 且路径含空格会崩
Ctrl+B 不是编译器，只是调用你本地的 ghdl 命令。不配构建系统，就只能手敲终端；配错，会报 Unable to find executable 或静默失败。
- 菜单 →
Tools → Build System → New Build System，粘入以下内容（Windows 示例）：{ "cmd": ["ghdl","-a","$file"], "file_regex":"^\s*(.*?):(\d+):?(\d+)?:?\s*(.*)$", "selector":"source.vhdl", "shell": true } -
"shell": true必须保留——否则路径含空格或中文时，$file会被截断 -
$file是完整路径，别写成$file_base_name或硬编码如C:/project/top.vhd - 保存为
VHDL.sublime-build，再通过菜单选中它；确保ghdl已加入系统PATH，终端里能直接运行ghdl --version
别碰 SublimeLinter-contrib-xvhdl 这类“实时检查”插件
网上教程常推它做语法检查，但它依赖早已停止维护的 xvhdl 工具链，不兼容 Sublime Text 4，Windows 下大概率启动失败，报错类似 linter crashed: xvhdl not found 或完全无响应。
- 真正可用的 lint 方式只有：在构建系统里追加
ghdl -c或ghdl -r步骤，或手动终端执行验证 - 如果非要集成进
Ctrl+B，可改"cmd"为：["ghdl", "-a", "$file", "&&", "ghdl", "-c", "$file_base_name"]（Windows +shell: true下有效） - 所有基于 LSP 的 VHDL 补全方案（如
vhdl-lsp）当前生态极不稳定，普通 FPGA 开发者不建议折腾
Vivado 调用 Sublime 前必须先加环境变量
Vivado 是靠命令行调外部编辑器的，不把 Sublime 加进 PATH，点“Edit Source”会直接报错或打开记事本。
- Windows：系统环境变量 →
Path新增 Sublime 安装目录（如C:\Program Files\Sublime Text），确保里面包含subl.exe或sublime_text.exe - 验证：终端运行
subl --version或sublime_text --version能返回版本号 - Vivado 设置：Tools → Options → General → External Tools → Editor，填入
subl -n -w（推荐）或sublime_text -n -w；-n -w表示新窗口 + 阻塞等待保存
file_regex 若写错，错误行跳转就失效；而 Vivado 和 Sublime 之间传参若没加 -w，保存后仿真可能读到旧文件。这些细节不显眼，但一漏就卡半天。
