Sublime Text 中可参数化代码片段需创建 .sublime-snippet 文件，置于 Packages/User/ 目录，用 <content><![CDATA[...]]></content> 包裹含 $1、${1:default} 占位符的代码，并通过 <scope>（如 source.js）限定语言环境，修改后需重启或清缓存生效。
怎么在 Sublime Text 里定义可参数化的代码片段（snippet）
Sublime 的代码模板本质是 .sublime-snippet 文件，不是快捷键或插件，也不依赖第三方包。它用 XML 写，核心是 <content></content> 和 <tabtrigger></tabtrigger>，但真正让模板“活起来”的是 $1、$2 这类占位符——它们支持跳转和默认值，不是简单字符串替换。
常见错误是把 HTML 或 JS 片段直接粘进去就完事，结果换行缩进错乱、变量名没高亮、按 Tab 跳不到下一个位置。这是因为没写 包裹内容，也没用 $1 标记焦点。
- 必须把实际代码写在
内部，否则 XML 解析会失败或转义出错 -
$1是第一个光标停靠点，$2是第二个……按 Tab 顺序切换；$0是最终退出点 - 想给占位符设默认值，写成
${1:default_text}，比如${1:props} - 文件保存路径必须是
Packages/User/xxx.sublime-snippet，扩展名不能是.txt或漏掉-snippet
<snippet>
<content><![CDATA[
function ${1:name}(${2:args}) {
$0
}
]]></content>
<tabTrigger>fn</tabTrigger>
<scope>source.js</scope>
</snippet>
如何让一个 snippet 只在特定语言（比如 Vue 或 Python）中生效
靠 <scope> 字段控制，不是靠文件名或文件夹。Sublime 每打开一个文件，都会根据语法高亮配置（.sublime-syntax 或 .tmLanguage）分配一个作用域（scope），比如 source.python、source.vue、text.html.basic。写错 scope，snippet 就压根不弹。
查当前文件真实 scope：按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Developer: Show Scope Name，光标所在位置会显示完整 scope 链，取最末一级或组合常用项即可。
- Vue 单文件组件脚本区常用
source.vue source.js（空格分隔，表示“同时匹配”） - Python 函数内写 snippet，用
source.python meta.function.python更精准，避免在字符串里误触发 - HTML 模板中用
text.html.basic，但若用了 Pug 或 JSX，scope 完全不同，不能硬套 - scope 区分大小写，
source.js≠source.JS
为什么改了 snippet 文件，Tab 触发没反应？
Sublime 不自动重载 snippet，改完必须重启软件，或手动清缓存。更隐蔽的问题是：文件编码不是 UTF-8 无 BOM，或者 XML 格式有误（比如多了一个 </content> 闭合标签），这时 Sublime 会静默忽略整个文件，不报错也不提示。
- 检查文件是否真在
Packages/User/目录下——用菜单Preferences → Browse Packages…打开，别放在子文件夹里 - 确保文件名以
.sublime-snippet结尾，且没有重复的.sublime-snippet.sublime-snippet - 如果用了中文注释或变量名，确认保存时选的是
UTF-8，不是GBK或UTF-8 with BOM - 临时禁用所有插件（
Preferences → Package Control → Disable Package），排除插件劫持 tab 行为的可能
能不能动态生成 snippet（比如根据当前文件名插入 import 路径）
原生 snippet 不支持运行时计算，$TM_FILENAME 这类环境变量只在 TextMate 兼容模式下有限支持，Sublime 实现不完整，经常为空或报错。真要动态逻辑，得切到插件开发，用 Python 写 TextCommand，监听 on_query_completions 或绑定快捷键。
但多数场景有折中方案：用多个静态 snippet + 合理的 <tabTrigger> 命名区分，比如 imp-rel 插入相对路径 import，imp-abs 插入绝对路径，再配合项目级 jsconfig.json 或 tsconfig.json 让编辑器自己补全路径，比硬塞逻辑更稳。
- 别在 snippet 里写
$TM_FILEPATH或$CURRENT_YEAR，Sublime 基本不认 - 需要日期/时间戳，用外部工具生成后粘贴，或装
InsertDate这类轻量插件，不强耦合到 snippet 流程里 - 路径拼接类需求，优先考虑语言服务（如 TypeScript Server）或 LSP 插件的自动 import 功能，比手写模板靠谱
复杂点在于 scope 判断和占位符嵌套——比如在 JSX 中写一个带 { } 包裹的表达式 snippet，$1 放里面还是外面，直接影响后续编辑流。这个得试三次以上才能调顺。
