Sublime中Ctrl+/默认添加行注释而非块注释,因块注释需语法包定义block_comment规则;支持语言限JS/HTML/CSS等,Python等未定义故仅逐行加#;正确块注释快捷键为Ctrl+Shift+/(macOS为Cmd+Option+/),依赖语法配置生效。

Sublime 给选中代码块加块注释,不是按 Ctrl+/ 就能自动包裹的——它取决于当前语法是否定义了 block_comment 规则,且默认只在 JavaScript、HTML、CSS 等少数语言中生效。
为什么选中后按 Ctrl+/ 只加了 // 或 #?
这是 Sublime 的默认行为:只要没明确定义块注释规则,它就退化为“逐行加行注释符”。Python、Ruby、Go、Shell 等语言的原生语法包里压根没配 block_comment 字段,所以哪怕你选中十行,Ctrl+/ 也只会每行开头塞一个 #,不会生成 """ 或 =begin ... =end。
- 检查方式:菜单
Preferences → Package Settings → [当前语法名] → Settings,看是否有"block_comment": ["/*", "*/"]这类字段 - 常见支持块注释的语言:JavaScript(
/* */)、HTML(<!-- -->)、CSS(需插件补全) - Python 官方不鼓励块注释,
"""是字符串字面量,不是注释语法;强行配block_comment可能和black或autopep8冲突
Ctrl+Shift+/ 是触发块注释的正确快捷键
这个组合键调用的是 toggle_block_comment 命令,而非 Ctrl+/ 那个 toggle_comment。它会优先尝试用 block_comment 规则包裹选区,失败才回落到行注释。
- Windows/Linux:按
Ctrl+Shift+/(注意是小键盘 / 或主键盘 /,非数字键) - macOS:按
Cmd+Option+/ - 如果仍无效,说明当前语法没定义
block_comment,或你正处在字符串、注释行、折叠区域等被跳过的上下文中 - 可手动验证:选中一段代码 →
Ctrl+Shift+P→ 输入Comment: Toggle Block Comment→ 回车
想让 Python/.env/JSX 等文件也支持块注释?得改语法配置
不能只改快捷键,得让 Sublime “知道”这段代码该用什么符号包裹。核心是往语法设置里加 block_comment 或 lineComment 字段,路径在 Preferences → Settings – Syntax Specific。
- 例如给
.env文件加#行注释:打开一个.env文件 →Preferences → Settings – Syntax Specific→ 加入:{"lineComment": "#"} - 给 Vue 的
<script></script>块加/* */:需编辑Vue Component语法的comments配置,或安装Vue Syntax Highlight插件并确认其含block_comment定义 - 修改后要重启 Sublime 或重载语法(右键 →
Revert to Saved),否则不生效
真正卡住人的地方,从来不是快捷键记不住,而是 Sublime 的注释逻辑完全由语法包决定——哪怕你写了一百行 //,如果右下角显示的是 Plain Text,Ctrl+/ 就只是插入符号,不会做任何识别或取消逻辑。

















