Sublime Text 默认不支持 Verilog 语法高亮,需通过 Package Control 安装 hobofan 的 Verilog 包;安装后 .v 文件自动高亮,.sv 文件需手动关联语法,且须确认使用 v3.0+ 版本以支持 SystemVerilog 关键字。

Sublime Text 默认不支持 Verilog 语法高亮,必须手动安装语言定义包;直接打开 .v 或 .sv 文件只会显示纯文本,关键词、模块结构、注释等全部无色。
如何安装 Verilog 语言包(Package Control 方式)
这是最稳定、更新及时的方式,依赖 Package Control 插件。若尚未安装 Package Control,需先通过官网获取 Python 安装脚本并运行——但多数用户已预装。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)呼出命令面板 - 输入
Package Control: Install Package并回车 - 搜索
Verilog,选择Verilog(作者:hobofan,仓库名sublime-verilog)安装 - 安装完成后,
.v文件会自动启用高亮;.sv文件需手动设置语法:右下角点击当前语法名 →Open all with current extension as...→ 选Verilog/Verilog
为什么 .sv 文件没高亮?
Sublime 不会默认将 .sv 关联到 Verilog 语法,即使安装了语言包。它只默认绑定 .v。这是硬编码在 Verilog.sublime-syntax 文件里的 scope 规则。
- 手动关联一次后,该扩展名会写入
Preferences.sublime-settings的extensions字段 - 也可编辑
Verilog/Verilog.sublime-syntax文件(通过Preferences → Browse Packages → Verilog进入),在file_extensions列表里添加sv - 注意:升级语言包时手动修改会被覆盖,推荐用第一种“Open all with...”方式
module、always_ff 等关键字没变色?检查 scope 是否生效
高亮失效常因 Sublime 误判语法类型,比如文件开头有 UTF-8 BOM 或特殊注释,导致 parser 跳过语法识别;也可能被其他插件(如 PlainNotes)劫持了语法绑定。
- 用
Ctrl+Shift+P→ 输入Developer: Show Scope Name,光标停在module上,看底部状态栏是否显示source.verilog - 若显示
source.plain或text.html,说明语法未正确加载,重启 Sublime 或禁用冲突插件再试 - Verilog 2001 和 SystemVerilog 关键字不同:
always_comb、logic在旧版语言包中不识别,需确认安装的是支持 SV 的版本(sublime-verilogv3.0+)
% cat ~/Library/Application\ Support/Sublime\ Text/Packages/Verilog/Verilog.sublime-syntax | grep -A5 file_extensions file_extensions: - v - vh - sv - svh
真正麻烦的不是装不上,而是装上后发现 interface 或 package 块里嵌套的语法 scope 没被完整捕获——这属于语言包自身的语法解析局限,不是配置问题。遇到这类情况,别折腾正则匹配规则,换用 VS Code + veriloghdl 插件更省心。










