Ctrl+/是行级注释开关：未选中时仅注释光标所在行，选中多行则逐行加/删//或#；失效主因是右下角语法显示Plain Text或Unsupported syntax，需手动切换语法；真正块注释用Ctrl+Shift+/，但依赖语言是否支持blockComment且选区合规。
Ctrl+/ 为什么有时只注释一行，有时又整段失效？
它根本不是“块注释”功能，而是「当前行 or 选中行」的行级开关：没选中任何文本时，只处理光标所在行；选中多行时，对每一行开头插入或移除 // 或 #，不包裹、不嵌套。如果按了没反应，大概率是右下角显示 Plain text 或 Unsupported syntax——这种状态下快捷键静默失效，不会报错也不会提示。
常见触发条件包括：文件无后缀（如临时粘贴的代码片段）、编码异常、语法缓存错误。临时解决方法是菜单栏 View → Syntax → 手动选对语言（如 Python、JavaScript），或用 Ctrl+Shift+P 输入 Set Syntax: Python 快速切换。
真正能包裹代码块的快捷键是哪个？
要用 Ctrl+Shift+/（Windows/Linux）或 Cmd+Option+/（macOS），但有两个硬性前提：
- 当前语言必须支持块注释（如
JavaScript、CSS、C++支持/* */；Python不支持，所以该快捷键在 .py 文件里直接无效） - 选区必须“合规”：不能跨空行、不能包含已注释行的混杂结构，否则 Sublime 会退化为行注释或干脆不响应
例如在 JS 文件中选中 3 行函数体，按 Ctrl+Shift+/ 会生成 /* ... */ 包裹；但如果第 2 行已经是 // todo，Sublime 可能拒绝操作，或只对未注释的行加 //。
怎么让 Ctrl+/ 支持自定义语言或修复失效？
默认行为由语言包（syntax definition）决定，不是全局配置。如果你在 YAML、TOML 或自定义 DSL 中想用 Ctrl+/，得确认对应语法包是否定义了 line_comment 规则。检查路径：Packages/YAML/YAML.sublime-syntax 是否含类似字段：
contexts:
main:
- match: '#'
scope: punctuation.definition.comment.yaml
push: comment
若缺失，快捷键必然失效。此时可：
- 安装社区语法包（如
YAMLMate），比原生支持更全 - 手动在
Preferences → Package Settings → YAML → Settings里补配置（需熟悉 sublime-syntax 格式） - 退而求其次：用命令面板
Ctrl+Shift+P输入Toggle Line Comment，它比快捷键容错稍高
自定义快捷键时 block 参数到底起什么作用？
在 Key Bindings 里加这条：
{"keys": ["ctrl+shift+c"], "command": "toggle_comment", "args": {"block": true}}
其中 {"block": true} 并不等于“强制块注释”，而是告诉 Sublime：“优先尝试块注释逻辑，失败则 fallback 到行注释”。实际效果仍受语言限制——在 Python 里设 block: true，按下去还是每行加 #，因为底层根本不提供 /* */ 的语法支持。
容易被忽略的一点：这个参数对取消注释也生效。比如你用 block: true 注释了 JS 块，再按一次，Sublime 会尝试移除整个 /* */ 包裹；但如果中间手动改过内容导致匹配失败，它可能只删掉开头 /*，留下孤零零的 */。
