Sublime Text 的注释功能依赖当前语法类型:单行注释默认用 Ctrl+/(Win/Linux)或 Cmd+/(macOS),需确保语法正确且快捷键未被插件覆盖;多行注释实为逐行添加单行注释符,非自动包裹块注释,Python 不原生支持 """ """ 块注释,HTML 和 JavaScript 则分别生成 和 //;如需通用块注释,须安装插件(如 Toggle Block Comment)或配置 snippet。

Sublime Text 默认支持单行和多行注释,但是否生效取决于当前文件的语法类型(即右下角显示的 Python、JavaScript、HTML 等),且部分语言需手动触发多行注释而非自动包裹。
单行注释快捷键失效?先确认语法类型和键位绑定
Sublime 的单行注释功能依赖两个条件:当前视图有正确语法定义(如 JavaScript 而非 Plain Text),且快捷键未被插件覆盖。默认键位是:
- Windows / Linux:
Ctrl + / -
macOS:
Cmd + /
如果按下无反应,检查右下角语法名称是否为实际语言;若显示 Plain Text,点击它 → 选择对应语言(如 Python)。另外,某些插件(如 Emacs Pro Essentials)会劫持该快捷键,可临时禁用插件验证。
多行注释不是自动“包裹”,而是调用语言专属命令
Sublime 不像 VS Code 那样按一次 Ctrl + Shift + / 就自动加 /* */ 或 {# #}。它的多行注释本质是执行 toggle_comment 命令,行为由当前语法的 comment.tmPreferences 文件决定:
- 对
JavaScript:选中多行后按Ctrl + /,每行前加// - 对
HTML:同样按Ctrl + /,会自动套上 - 对
Python:只支持单行#,不生成""" """块注释(那是编辑器功能,非 Sublime 原生)
想强制用块注释?得装插件(如 Comment-Snippets)或手动输入符号。
自定义多行块注释:改配置或用插件更可靠
原生 Sublime 不提供通用块注释快捷键,但可通过以下方式补足:
- 安装插件
Toggle Block Comment(通过 Package Control),启用后支持Ctrl + Shift + /插入语言适配的块注释(如 JS 的/* ... */、HTML 的) - 手动修改语法配置(高级):在
Packages/User/Comments-中写入.sublime-settings block_comment规则,但需了解 Sublime 的 scope 机制,容易出错 - 用 Snippet 快速插入:新建 snippet,内容为
,绑定 tab 触发,适合高频 HTML 注释
{
"scope": "source.html",
"tabTrigger": "cm",
"contents": ""
}
真正容易被忽略的是:Sublime 的注释行为完全由语法包定义,不是全局统一逻辑。同一个快捷键在不同文件里表现不同,不是 bug,是设计如此——所以别硬记“多行注释键”,先看右下角语法名再说。










