<p>Ctrl+Shift+/是块注释触发器，用语言原生符号（如/ /、<!-- -->）包裹选区，但需语法明确定义comment_start/end且选区不跨空行或含已注释内容。</p>
Ctrl+Shift+/ 不是“多行注释”，而是块注释触发器
它不会给每行加 // 或 #，而是尝试用语言原生的块注释符号（如 /* */、<!-- --> ）包裹整个选区。但能否成功，取决于两个硬条件：当前语法必须明确定义 comment_start 和 comment_end，且选区不能跨空行或含已折叠/已注释内容。
- JavaScript、CSS、C++、Java 默认支持，按
Ctrl+Shift+/后会生成/* ... */ - Python 的
source.python语法包默认没定义块注释字段，所以该快捷键在.py文件里直接无效 - HTML 中选中几行标签，会套上
<!-- -->；但若选区包含未闭合的<script>，可能只注释部分行 - JSON 文件默认不支持任何注释——需先切换为
JSONC语法（安装插件后），否则Ctrl+Shift+/和Ctrl+/都静默失败
为什么 Ctrl+/ 按了没反应？90% 是右下角语法名错了
Sublime 不看文件后缀，只认右下角显示的语法标识。显示 Plain Text、Unsupported syntax 或错切成 JSON 时，Ctrl+/ 就会完全失效：不报错、不提示、也不加符号。
- 新建未保存文件默认是
Plain Text，必须手动设置：按Ctrl+Shift+P→ 输入Set Syntax: Python（或Shell-Unix-Generic、JavaScript）→ 回车 -
.env、.conf、.toml等冷门后缀常被识别为Plain Text，需主动切到Shell-Unix-Generic才能用#注释 - Windows 用户常见干扰是中文输入法激活时劫持
/键，切英文状态再试 - 插件如
Emacs Pro Essentials或Comment-Snippets可能覆盖原生绑定，临时禁用可验证
光标位置和选区状态决定 Ctrl+/ 实际作用范围
Ctrl+/ 的行为极其严格，没有推测逻辑，只响应明确的上下文：
- 未选中任何文本时：只操作光标所在整行，哪怕光标停在第 5 个字符，也会整行加/删
//或# - 选中多行时：对每行开头单独加/删行注释符，不是包裹式块注释；跨空行或缩进不一致时仍逐行处理，可能导致格式错乱
- 光标落在字符串内（如
"hello"中）、已有注释行里、或折叠区域内部时：Ctrl+/默认不触发（避免误操作） - 想统一在某几行中间插入
//（比如调试日志前缀），快捷键无能为力，得用列模式：按住Alt+ 鼠标拖选目标列，松手后直接输入//
语法不支持块注释？用自定义键绑定兜底
如果当前语言不支持 Ctrl+Shift+/（如 Python），又不想手动敲 #，可以绕过语法限制，强制启用块注释逻辑：
- 打开
Preferences → Key Bindings，在右侧用户配置中添加：
[ {"keys": ["ctrl+alt+/"], "command": "toggle_comment", "args": {"block": true}} ]Ctrl+Alt+/ 会忽略语法是否定义 comment_start，强行用 /* */ 包裹选区（即使 Python 文件也生效）"block": true 改成 false
/* */ 是非法语法），仅用于临时屏蔽代码真正“一键注释整段”的可靠路径，从来不是靠猜快捷键组合，而是先确认右下角语法名、再判断语言是否支持块注释、最后根据选区结构选择对应操作——三者缺一不可。
