ctrl+/ 是 sublime text 基础行注释快捷键，按语法自动添加//或#，但不识别代码结构；ctrl+shift+/ 为块注释，依赖语言插件配置；comment-snippets 插件提供智能上下文感知注释；自定义 key binding 可实现注释并折叠联动。
Ctrl+/ 适用于单行或连续多行，但不处理嵌套结构
这是 Sublime Text 最基础的注释快捷键，对选中的每一行都添加或移除 //（JavaScript/TypeScript/C++ 等）或 #（Python），取决于当前语法高亮模式。它不识别代码块边界，比如在 if 块内只选中中间两行按 Ctrl+/，不会自动补全 if 和 end 或大括号，只是机械地注释/取消注释所选行。
常见错误现象：在 Python 中选中缩进后的几行按 Ctrl+/，结果每行都加了 #，但缩进层级被破坏，导致语法错误；在 JSX 中对部分标签行注释后，JSX 结构不闭合，保存时 ESLint 报 unclosed JSX tag。
- 确保光标位于正确语法模式下（右下角显示
Python、JavaScript等），否则可能插入错误符号 - 若当前文件未设置语法类型（显示
Plain Text），Ctrl+/默认用//，易引发 Python 语法错误 - 对空行也生效，注释后可能产生大量无意义的
#行，建议先手动过滤空行再操作
Ctrl+Shift+/ 触发块注释，但依赖语言插件支持
Ctrl+Shift+/ 的行为由当前语言的 comments 配置决定，不是所有语言都启用块注释。例如 JavaScript 支持 /* ... */，Python 插件（如 Python Improved）可配置为用 """ 包裹，而原生 Sublime 的 Python 模式默认不响应该快捷键。
使用场景：想临时禁用一段函数逻辑（含多层缩进、条件分支、循环），又不想逐行删改，这时块注释比 Ctrl+/ 更安全。
- 检查是否生效：打开一个
.js文件，选中几行，按Ctrl+Shift+/，应出现/*和*/包裹；若无反应，说明当前语法未定义block_comment - 配置路径：可通过
Preferences → Package Settings → [语言名] → Settings查看或添加"block_comment": ["/*", "*/"] - 注意嵌套限制：JavaScript 不允许
/* /* inner */ outer */，Sublime 不做嵌套校验，手动写错会导致编译失败
安装 Comment-Snippets 插件实现智能块注释
原生 Sublime 对块注释的支持较弱，尤其在 Python、HTML、JSON 等场景下容易出错。Comment-Snippets 是目前最稳定的第三方方案，它会根据光标位置自动判断上下文，比如在函数体内部触发时，优先包裹整个函数而非仅选中行。
安装后，常用组合是 Ctrl+Alt+/（默认绑定），支持：def 函数 → 用 """ 包裹；if 块 → 自动找匹配的 end 或 }；HTML 标签 → 用 <!-- --> 包裹整个标签树。
- 安装方式：通过 Package Control →
Install Package→ 搜索Comment-Snippets，重启后生效 - 冲突排查：若快捷键无效，检查是否与其他插件（如
Emacs Pro Essentials）绑定冲突，可在Preferences → Key Bindings中搜索comment_snippets - 不兼容场景：在未闭合的 JSON 文件中（如缺逗号或引号），插件可能无法准确定位块边界，建议先修复语法错误再使用
自定义 key binding 实现“注释并折叠”联动
真正提升效率的不是单纯注释，而是注释后立刻隐藏代码块。Sublime 支持将多个命令链式绑定，比如先执行 toggle_comment，再执行 fold。这对调试大型配置文件或临时屏蔽旧逻辑特别有用。
示例：为 Python 添加一键注释+折叠绑定，在 Preferences → Key Bindings 用户文件中加入：
[
{
"keys": ["ctrl+alt+shift+/"],
"command": "run_macro_file",
"args": {"file": "Packages/User/toggle_comment_and_fold.sublime-macro"}
}
]
对应 macro 文件 Packages/User/toggle_comment_and_fold.sublime-macro 内容为：
[
{"command": "toggle_comment", "args": {"block": false}},
{"command": "fold"}
]
- 必须用
run_macro_file而非直接写多个command，否则第二步fold会作用于原始光标位置，而非注释后的新结构 -
"block": false表示走行注释逻辑（更稳定），设为true则尝试块注释，但某些语言下可能失败 - 折叠效果依赖代码折叠规则（
folding设置），Python 需开启"fold_python_code": true（在Preferences → Settings中）
实际用下来，多数人卡在第一步：没确认当前文件语法类型是否正确。哪怕只是临时把 .txt 改成 .py 后缀，Sublime 也不会自动切换语法高亮，Ctrl+/ 就仍按文本模式处理——这个细节几乎每次重装系统后都会有人踩。
