Sublime Text 的 snippet 无法直接绑定快捷键，因快捷键系统仅识别命令名而 snippet 机制独立，必须通过 insert_snippet 命令配合 args（name 或 contents）调用；路径须为 Packages/ 开头的正斜杠格式，变量仅在 contents 中生效，跳位需 selection_empty 等 context 支持。
不能直接给代码块（snippet）绑热键，必须转成命令再绑定——insert_snippet 是唯一能触发 snippet 的原生命令，且必须通过 args 显式传入 snippet 路径或内容。
为什么 snippet 不能像普通命令一样直接绑定快捷键？
Sublime 的 snippet 机制和快捷键系统是两套独立逻辑：snippet 靠 tabTrigger + Tab 触发，而快捷键绑定只认 command 字符串。你写 "command": "my_custom_snippet" 是无效的，Sublime 根本不认识这个名字。
- 所有 snippet 的执行入口统一为
insert_snippet，没有例外 -
insert_snippet不接受 snippet 名字，只接受两种参数：{"contents": "..."}（内联文本）或{"name": "Packages/User/my.snippet"}（路径） - 路径必须用正斜杠，且以
Packages/开头；相对路径、本地文件系统路径（如C:/...）全部失效
怎么用快捷键一秒插入 HTML5 模板？
假设你已建好 Packages/User/html5.sublime-snippet，内容含 <!DOCTYPE html> 等结构。要在任意 HTML 文件中按 Ctrl+Alt+H 插入它，就在 User.sublime-keymap 里加：
[{
"keys": ["ctrl+alt+h"],
"command": "insert_snippet",
"args": {
"name": "Packages/User/html5.sublime-snippet"
},
"context": [
{"key": "selector", "operator": "equal", "operand": "text.html.basic"}
]
}]- 必须加
context，否则在 Python 文件里按也会尝试加载 HTML snippet，报错且不提示 - 如果 snippet 里用了
$1、$2跳位点，insert_snippet会原样保留并激活，和手动 Tab 触发行为一致 - 路径拼错时，快捷键静默失效——右下角不报红，控制台也不打日志，只能靠删掉
context后在纯文本里试，看是否弹出 “Snippet not found” 提示
想动态生成带当前文件名的模板？别硬塞 snippet，改用内联内容
比如要插入含 class MyFileName: 的 Python 模板，但每次文件名不同。这时不要折腾 snippet 变量，直接把内容写进 args.contents：
[{
"keys": ["ctrl+alt+p"],
"command": "insert_snippet",
"args": {
"contents": "#!/usr/bin/env python3\n# ${file_base_name}.py\n\nclass ${file_base_name}:\n pass"
},
"context": [
{"key": "selector", "operator": "equal", "operand": "source.python"}
]
}]-
${file_base_name}这类变量仅在contents字符串中生效，在外部 snippet 文件里不解析 - 所有 Sublime 变量都支持：
$1、${1:default}、${file_path}、${date}等，但不能嵌套（如${file_path:${file_base_name}}无效） - 换行必须用
\n，不能用真实回车；引号需转义，例如"contents": "print(\"hello\")"
快捷键插入后光标没跳到 $1？检查 context 是否漏了 selection_empty
常见现象：按完热键，模板插进去了，但光标停在末尾，而不是第一个 $1 位置。这不是 bug，是 Sublime 默认行为——它只在“无选区 + 光标在空行”等安全上下文中才激活跳位。
- 加这个 context 条件可强制激活：
{"key": "selection_empty", "operator": "equal", "operand": true} - 如果模板里有多个
$1，它们会变成同一跳位组；想分步跳，得改用$1、$2、$3 - 用
sublime.log_commands(True)在控制台观察：触发后若没看到command: insert_snippet日志，说明快捷键根本没走到命令层，大概率是 context 不匹配或 JSON 格式错
真正卡住人的不是语法，而是变量作用域和 context 的隐式组合——${file_base_name} 在 contents 里有效，在外部 snippet 文件里无效；selection_empty 不加，跳位就失效；路径写成 User/html5.sublime-snippet 少了 Packages/ 前缀，就彻底静默失败。这些细节不实测，光看文档永远调不通。
