Verilog在Sublime中不亮、logic/always_ff灰色、mod按Tab无反应，根本原因是未加载语法定义：必须精确安装VerilogHighlighter插件（大小写敏感、无空格连字符），重启后手动将.sv文件绑定为SystemVerilog语法，且状态栏须显示SystemVerilog而非Plain Text。
Verilog 在 Sublime Text 里不亮、logic 和 always_ff 全是灰色、敲 mod 按 Tab 没反应——不是你配置错了，而是 Sublime 根本没加载语法定义。90% 的问题卡在这三步：插件名拼错、.sv 文件没绑定到 SystemVerilog 语法、装完没重启。
VerilogHighlighter 必须精确安装，其他名字全无效
Sublime 默认完全不认识 .v 或 .sv 文件。网上搜到的 Verilog Syntax、Verilog-HDL、Verilog-SystemVerilog 都不能用。真正起作用的只有一个：VerilogHighlighter（首字母大写、无空格、无连字符、结尾无 s）。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: Install Package回车 - 在弹出的搜索框中**逐字输入
VerilogHighlighter**，注意大小写和拼写，选中后回车 - 安装完必须重启 Sublime Text，否则插件不会激活
- 如果之前装过其他 Verilog 插件（如
Verilog-HDL），建议先禁用或卸载，避免scope冲突
.sv 文件必须手动绑定为 SystemVerilog 语法
.v 文件通常能自动识别为 Verilog，但 .sv 是硬编码未映射的扩展名。新建 test.sv 后右下角显示 Plain Text 是正常现象，不手动切，interface、typedef struct、logic 永远是灰色。
- 点击右下角
Plain Text→ 选择SystemVerilog（不是Verilog，也不是VHDL） - 更稳妥做法：菜单栏 →
View→Syntax→Open all with current extension as…→ 选SystemVerilog - 检查
Preferences → Settings – User中是否误加了类似"extensions": ["sv"]→"syntax": "Packages/Text/Plain text.tmLanguage"的规则，有就删掉 - 验证方式：按
Ctrl+Shift+P→ 输入Developer: Show Scope Name，光标停在module上，状态栏应显示source.systemverilog
代码片段（mod / alw / if）只在正确 scope 下按 Tab 触发
Sublime 不提供语义感知补全，mod 不会自动弹窗，只响应「完整缩写 + 紧跟 Tab」，且严格依赖当前 scope。
- 右下角状态栏必须显示
SystemVerilog（.sv）或Verilog（.v），显示Plain Text或Comment就完全不响应 - 输入
mod后光标必须停在末尾，**立刻按Tab** —— 按空格、回车、鼠标点别的地方都会中断触发 - 不能在注释里、字符串里、已缩进的行首、或
/* */块里敲缩写，那些位置的scope是comment.block或string.quoted，不匹配source.systemverilog - 自定义
.sublime-snippet时，<scope>字段必须设为source.systemverilog或source.verilog，写成source或source.verilog.systemverilog都无效
构建系统里 $file 等变量必须加双引号
构建命令中路径含空格或中文时，不加引号会导致 iverilog 直接报错或静默失败。Windows 下默认安装路径如 C:\Program Files\，不加引号必崩。
- 正确写法：
"cmd": ["iverilog.exe", "-o", "$file_base_name", "$file"] - 错误写法：
"cmd": ["iverilog.exe", "-o", "$file_base_name", $file]（$file未包裹） - 验证方式：运行构建后看 Sublime 底部状态栏是否显示
[Finished]；若闪退或无输出，大概率是路径解析失败 - 如果用
shell_cmd，路径变量需用双引号包裹并转义，例如："shell_cmd": "cd \"$file_path\" && iverilog -o \"$file_base_name\" \"$file\""
最易被忽略的是 scope 验证和变量引号——很多人反复重装插件却跳过 Developer: Show Scope Name 这一步，也常把 $file 当普通字符串直接塞进 cmd 数组里。这两处一错，整个环境就卡在“看起来装好了，实际全失效”的状态。
