Sublime Text 单行注释快捷键需在右侧 User.sublime-keymap 中以合法 JSON 数组格式覆盖，默认命令为 "toggle_comment"，并须添加 context 限定作用域（如 source.python）才生效。
Sublime Text 的单行注释快捷键（默认是 ctrl+/）不能“修改”，只能在 User.sublime-keymap 中用新规则覆盖——写对就生效，写错就静默失效，不报错也不提示。
怎么打开并编辑正确的 User.sublime-keymap 文件
必须走正确路径，否则改了也白改：
- 点击菜单 Preferences → Key Bindings，会并排打开两个文件：左侧只读的
Default (Windows).sublime-keymap（或对应系统名），右侧可编辑的User.sublime-keymap - 所有自定义都必须写在右侧文件里；首次打开时可能为空，但必须保持合法 JSON 数组格式，哪怕只加一条，也要用方括号
[ ]包裹 - 别碰左侧文件——升级后会被覆盖，且可能因格式错误导致整个快捷键系统瘫痪
单行注释命令名不是 toggle_comment 就是 run_macro_file
不同版本、不同插件环境下的命令名不统一，靠猜大概率失败。真实可用的 command 名只有两种常见情况：
- 原生支持（无额外插件）：用
"command": "toggle_comment"，这是 Sublime 内置的通用注释切换命令，适用于source.python、text.html等大多数作用域 - 旧版或特殊语言包：可能需调用宏文件，如
"command": "run_macro_file", "args": {"file": "res://Packages/Default/Comment Line.sublime-macro"} - 不确定用哪个？按
ctrl+shift+p输入 “toggle comment”，看命令面板里显示的完整标识；或者开控制台ctrl+`，输入sublime.log_commands(True)，再手动按一次默认ctrl+/，控制台会输出真实的command和args
加 context 才能在特定语言里生效
Sublime 的快捷键是按作用域（scope）绑定的，不是全局生效。直接写 {"keys": ["ctrl+;"], "command": "toggle_comment"}，在 Python 文件里可能没反应，在 JS 里反而触发了——因为没限定作用域。
查当前文件作用域的方法：打开一个 .py 文件，按 ctrl+shift+p 输入 show_scope_name 回车，状态栏会显示类似 source.python 的字符串。把这个加进 context：
[{
"keys": ["ctrl+;"],
"command": "toggle_comment",
"context": [
{ "key": "selector", "operator": "equal", "operand": "source.python" }
]
}]
- 多个语言要分别写多条规则，比如再加一条
source.js或text.html - 想让它在所有文本类文件里都生效？用
"operand": "text.plain"或更宽泛的"source"，但注意这可能和已有插件冲突 - 不加 context 的规则，默认只在
text.plain下生效，也就是纯文本模式——这不是你想要的
容易踩的坑：JSON 格式、组合键冲突、作用域漏判
90% 的“改了没反应”问题出在这三处：
- JSON 格式非法：末尾多逗号、引号用成中文、缺方括号、对象没用逗号隔开——Sublime 不报错，只是整段忽略
- 组合键被系统或输入法劫持：比如
ctrl+alt+d在某些 Windows 输入法下根本传不到 Sublime；优先选ctrl+shift+;或alt+shift+c这类低冲突组合 - 作用域写错或没覆盖全：比如写了
source.python，但你实际在source.python.django下编辑，就得用source.python做前缀匹配，或加多一层 context 判断
真正起效的那条规则，往往是在控制台确认过 command 名 + 用 show_scope_name 对过 scope + 用 JSON 验证器扫过语法之后才加进去的。
