Verilog语法高亮不生效是因Sublime未加载正确语法定义，须安装VerilogHighlighter插件并手动将.sv文件绑定为SystemVerilog语法；缩写补全需在对应作用域内输入后立即按Tab；构建系统需显式指定源文件或路径参数；Vivado调用需配置系统PATH并设editor为sublime_text。
Verilog语法高亮不生效？先确认插件名和文件关联
Sublime 默认完全不认识 .v 或 .sv 文件，所谓“不亮”不是配置错了，而是根本没加载语法定义。最常见错误是装了名字近似的插件，比如 Verilog Syntax 或 Verilog-HDL，但真正起作用的是 VerilogHighlighter（注意拼写、大小写、无空格）。
- 按
Ctrl+Shift+P→ 输入Package Control: Install Package→ 精确搜索并安装VerilogHighlighter - 重启 Sublime，新建
test.sv→ 点右下角Plain Text→ 手动选SystemVerilog（不是 Verilog） -
.v文件通常自动识别为 Verilog，但.sv必须手动绑定：菜单View → Syntax → Open all with current extension as… → SystemVerilog - 如果仍不亮，检查
Preferences → Settings – User里有没有类似"extensions": ["sv"]被强制映射成"Plain Text"的规则
代码片段（mod/always）按 Tab 没反应？检查作用域和触发方式
Sublime 的补全不是 IDE 那种语义感知弹窗，它靠的是“缩写 + Tab”，且只在当前语法作用域内生效。输入 mod 后光标停在末尾却没反应，大概率是因为右下角显示的不是 SystemVerilog，或者你正在注释里敲字。
- 确保状态栏显示
SystemVerilog（.sv）或Verilog（.v），不是Plain Text或VHDL -
mod、alw、if这类缩写必须完整输入后，**立刻按Tab** —— 不是回车，不是空格，不是点鼠标 - 想自定义模板？用
Tools → Developer → New Snippet…，scope字段必须设为source.systemverilog（.sv）或source.verilog（.v） - 别指望它补全你自己写的
interface或package名——那需要 LSP（如subl-lsp+slangserver），属于额外部署
构建系统调用 iverilog 报错“Unknown module type”？路径和参数要对齐
编译失败常被误认为语法问题，其实是构建系统没把当前目录或 include 路径传给 iverilog。典型报错是 Unknown module type: fifo_ctrl，说明它根本没看到 fifo_ctrl.v 文件。
-
iverilog默认不递归查找依赖，构建命令中必须显式包含所有源文件，或用-f filelist.f；单文件测试可简化为："cmd": ["iverilog", "-o", "$file_base_name", "$file"] - 路径含空格或中文？
"shell_cmd"中的$file必须加引号："shell_cmd": "cd \"$file_path\" && iverilog -o \"$file_base_name\" \"$file\"" - 想让
`include生效，得加-I参数指定头文件路径，例如："args": ["-I", "$file_path/include"] - SublimeLinter 的
iveriloglinter 默认不带-i，遇到未定义模块会直接报错；需在SublimeLinter Settings – User中加："args": ["-i"]
Vivado 里双击打开还是用自带编辑器？环境变量和设置要配平
Vivado 不读 Sublime 的安装路径，它只认系统环境变量里的可执行名。哪怕你桌面有快捷方式，Vivado 也找不到——除非你把它加进了 PATH，并且能从命令行直接敲名字启动。
- Windows 下，把 Sublime 安装目录（如
C:\Program Files\Sublime Text）加进系统环境变量Path，不是加sublime_text.exe全路径 - 命令行输入
sublime_text（注意下划线，不是sublime）回车，能立刻弹窗才说明环境变量生效 - Vivado 设置路径：
Tools → Settings → General → Editor→ Current Editor 下拉选sublime_text - Mac/Linux 用户注意：
sublime_text命令可能需手动软链到/usr/local/bin，否则 Vivado 找不到
最容易被忽略的一点：Sublime 的语法高亮和 lint 依赖文件后缀与作用域严格匹配。一个 .sv 文件若被误设为 Verilog 语法，always_ff 和 logic 就不会高亮，也不会触发 SV 片段——这种“几乎正常”的状态，比彻底不亮更难排查。
