合法 Sublime Snippet XML 文件需以 为根节点，保存为 .sublime-snippet 后缀，置于 Packages/User/ 目录；scope 必须匹配语法作用域（如 source.js），内容推荐用 CDATA 包裹，变量用 $1、${1:default} 等格式。
如何创建一个合法的 Sublime Snippet XML 文件
Sublime 的代码片段本质是 XML 文件，必须严格遵循 sublime-snippet 根节点结构，否则不会出现在片段列表中。常见失效原因就是漏了 <snippet></snippet> 外层包裹，或误用 .sublime-completions 扩展名。
- 文件必须保存为
xxx.sublime-snippet（后缀名不能错） - 根节点必须是
<snippet></snippet>，内部依次为<content></content>、<tabtrigger></tabtrigger>、<scope></scope>、<description></description> -
<content></content>中的换行和缩进会被原样插入，建议用 CDATA 包裹多行模板，避免转义问题 - 变量占位符用
$1、$2表示跳转顺序，$0是最终光标位置；重复变量如${1:name}可同步更新
<![CDATA[<snippet>
<content><![CDATA[console.log('${1:msg}', ${2:val});]]></CDATA></content>
<tabTrigger>log</tabTrigger>
<scope>source.js</scope>
<description>console.log with placeholder</description>
</snippet>]]>
scope 值怎么填才让片段只在 JS/HTML/CSS 中生效
<scope></scope> 不是文件后缀，而是 Sublime 内部的语法作用域（syntax scope），它由当前文件所用的 .sublime-syntax 或 .tmLanguage 定义。填错 scope 就等于“写了但永远触发不了”。
- JS 文件常用 scope：
source.js（ES5）、source.js.jsx（React）、source.ts（TypeScript） - HTML 文件：优先用
text.html.basic，若需区分 Vue/Svelte 模板，可用text.html.vue或text.html.svelte（依赖对应插件） - CSS/SCSS：用
source.css或source.scss，不要写成css或.css - 查当前文件真实 scope：按
Ctrl+Shift+P→ 输入Developer: Show Scope Name，光标所在位置会显示完整 scope 链
带多光标跳转和条件逻辑的高级片段写法
纯 / 只能线性跳转，复杂模板需要变量绑定、默认值、镜像同步甚至简单分支。Sublime 支持基础变量语法，但不支持运行时判断（如 if/else）。
- 同步修改同一变量：
${1:className}在多个位置出现，首次输入后其余位置自动更新 - 设置默认值：
${1:defaultText}，Tab 跳过时保留 defaultText；留空${1:}则跳过时不填内容 - 嵌套占位：
${2:${1:defaultValue}}表示第 2 个位置默认取第 1 个位置的值 - 避免意外覆盖：如果片段含
$符号（如正则$1或 CSS$color），必须写成\$1或\$color转义
片段不生效？检查这四个隐藏卡点
多数“写了没反应”问题不在代码本身，而在环境配置或路径细节。
- 片段文件没放在正确目录：应存于
Packages/User/（通过Preferences → Browse Packages…打开），而非Packages/Default/或任意子文件夹 - 文件编码不是 UTF-8 无 BOM：用 VS Code 或 Sublime 自身另存为 UTF-8，BOM 会导致解析失败
- 已有同名 snippet 被插件覆盖：比如 Emmet 也注册了
log，可临时禁用插件测试，或改用更特异的logd触发词 - scope 冲突：例如在 JSX 文件中同时匹配
source.js和source.js.jsx，Sublime 会选更具体的那个；若你只写了前者，就可能不生效
scope 和文件路径这两项，比内容语法更容易出问题，调试时优先确认它们。
