Ctrl+Shift+/在Python文件中无反应，因原生Python语法包未定义blockComment配置，Sublime仅依赖语法设置中的block_comment字段触发该命令，不自动推断"""或#包裹方式。
Ctrl+Shift+/ 为什么在 Python 文件里按了没反应？
因为 Python 语法包默认没定义 blockComment，toggle_block_comment 命令直接不可用。Sublime 不会“自动推断”你要用 """ 或 # 包裹——它只查当前语法配置里的 block_comment 字段。你打开一个 .py 文件，按 Ctrl+Shift+P 输入 Toggle Block Comment，如果命令不出现，就说明语法根本不支持块注释。
常见误操作包括：
- 以为选中多行后按
Ctrl+/就能生成包裹式注释（实际只是逐行加#） - 在未设置语法的临时文件里试，右下角显示
Plain Text，快捷键静默失效 - 装了 Commentary 插件后强行启用
"""，但和black、autopep8冲突，保存时被清掉
JavaScript/HTML/CSS 中 Ctrl+Shift+/ 跨行生效的硬性条件
这个快捷键不是“按下就包裹”，而是严格依赖三件事同时成立：
- 右下角语法名必须是
JavaScript、HTML或CSS（Vue Component默认不覆盖<script></script>块，需额外配置） - 选区必须连续、无空行、无缩进断裂（比如选中
if块中间两行，但漏掉if行和}行，可能生成不闭合的/*） - 不能有已存在的行注释混在选区内（如某行已有
// todo，Sublime 可能退化为逐行加//或直接不响应）
验证方法：新建 .js 文件，输入两行代码，选中后按 Ctrl+Shift+/；若没反应，再按 Ctrl+Shift+P → 输入 Toggle Block Comment 看是否可执行。
想让 .env 或 .toml 文件也支持块注释怎么办？
Sublime 允许通过用户语法设置补全注释规则，不用改插件源码。但必须手动指定语法标识和符号对：
- 先确认文件当前语法：点右下角 →
Set Syntax: Shell-Unix-Generic（适配.env）或Set Syntax: TOML（需安装 TOML 插件） - 打开
Preferences → Package Settings → [语法名] → Settings – User - 添加：
"block_comment": ["# ", ""]
（注意：第二项为空字符串，因.env无结束符） - 重启 Sublime 或重载语法，再试
Ctrl+Shift+/
风险提示：自定义 block_comment 后，如果符号对不匹配语言规范（如给 JSON 加 /* */），格式化工具可能报错或破坏结构。
跨空行、缩进混乱时怎么安全注释？
当你要注释的代码块含空行、缩进不齐、或部分折叠时，Ctrl+/ 和 Ctrl+Shift+/ 都容易出错。最稳妥的做法是分两步：
- 先按
Ctrl+Shift+P→ 输入Indentation: Reindent Lines，统一缩进层级 - 再手动删掉空行（或用正则
^\s*$替换为空），避免注释后产生大量无意义的#行 - 最后选中干净区域，用
Ctrl+Shift+/（支持块注释语言）或Ctrl+/（Python/Shell 等）
真正难处理的不是快捷键本身，而是混合状态：比如 JSX 中 用 HTML 语法高亮，<script></script> 却仍是 Plain Text —— 这时候必须切到对应语法作用域再操作，否则注释符号必然错乱。
