Ctrl+/ 是行级注释切换而非块注释,仅对选中行逐行添加/删除行注释符;块注释需 Ctrl+Shift+/ 且依赖语法定义的 blockComment 字段,.py 等语言常不支持。

Ctrl+/ 为什么不是“块注释”快捷键?
它本质是 toggle_comment 命令的行级开关:没选中时只处理光标所在行;选中多行时,对每行开头加/删 // 或 #,不包裹、不嵌套。所谓“批量注释”,只是视觉上连续多行被处理,实际逻辑仍是逐行判断。如果右下角显示 Plain Text,这个快捷键会静默失效——不报错,也不响应。
真正能包裹代码块的是 Ctrl+Shift+/,但有两个硬前提
它调用的是同一命令 toggle_comment,但带 {"block": true} 参数,行为完全取决于当前语法是否定义了 blockComment 字段:
-
.js、.css、.html默认支持:/* */或会被自动插入并闭合 -
.py文件基本无效:Python 语法包通常不定义blockComment,快捷键按下无反应 - 选区必须“干净”:不能跨空行,不能混杂已注释行(如第2行已有
//),否则 Sublime 可能退化为行注释或直接跳过
想强制跨语言用块注释?改用户键绑定最稳
不用动语法包,也不用装插件。打开 Preferences → Key Bindings,在右侧(用户配置)粘贴:
[{"keys": ["ctrl+alt+/"], "command": "toggle_comment", "args": {"block": true}}]
保存后,Ctrl+Alt+/ 就固定走块注释逻辑。它不会自己发明符号,但会严格读取当前语法定义的 blockComment 规则。如果某语言没定义,就什么也不做——这比覆盖语法配置更安全,升级不丢。
自定义 .env / .conf 等文件的注释支持
这类文件默认无注释规则,Ctrl+/ 必然失效。解决路径是“关联语法 + 补充注释符”,而非改快捷键:
- 先确认该文件类型有对应语法包(如
.env可关联到Shell-Unix-Generic) - 打开
Preferences → Browse Packages → User,新建Shell-Unix-Generic.sublime-syntax - 在文件顶部添加:
comment_line_start: '#' - 再用
View → Syntax → Open all with current extension as…把.env关联过去
做完这些,Ctrl+/ 才会在 .env 文件里真正生效。快捷键只是触发器,底层逻辑永远由语法定义驱动——这是最容易被忽略的底层约束。











