Sublime Text代码片段需同时满足后缀名.sublime-snippet、存于Packages/User/目录、内容为合法XML且根节点为<snippet>三个条件才能生效；tabTrigger不响应主因是scope不匹配，需用Show Scope Name确认并正确设置；多行模板中换行缩进需手动清理首尾空行，$1与${1:default}行为不同，$0仅可出现一次。
Sublime Text 的代码片段（snippet）不是“写完就能用”的功能，它对文件位置、XML 结构、作用域匹配和编码细节极其敏感——漏掉一个CDATA或存错目录，就完全不触发，且不报错。
如何确保 .sublime-snippet 文件被 Sublime 正确加载
文件必须同时满足三个硬性条件：后缀名是.sublime-snippet（不能是.snippet、.xml或隐藏的.txt），保存路径是Packages/User/（通过Preferences → Browse Packages…打开的就是正确位置），内容是合法 XML 且根节点为<snippet></snippet>。
常见失效原因：
- Windows 下默认隐藏扩展名，实际保存成了
log.sublime-snippet.txt——Sublime 完全无视 - 手动新建文本文件再改名，但编辑器没设 UTF-8 编码，含中文或特殊字符时解析失败
- 用了
File → Save As…却选错了目录，比如存到桌面或Packages/Default/
验证方式：改完后按Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输入Reload Syntax Definitions回车，强制刷新 snippet 列表。
为什么 tabTrigger 输入后没反应
最常见原因是<scope></scope>值与当前文件语法不匹配。Sublime 不会提示错误，只是静默跳过——你敲log + Tab，光标不动，不是快捷键冲突，是 scope 没对上。
查当前作用域的方法：Ctrl+Shift+P → 输入Show Scope Name回车，状态栏显示类似source.js.embedded.html或text.html.basic的字符串，取最前面那段（如source.js）填进<scope></scope>。
常用 scope 值参考：
- 纯 JS 文件：
source.js - Vue 单文件组件的
<script>区域：source.js.embedded.html - HTML 文件：
text.html.basic - CSS 文件：
source.css - 全局生效（慎用）：
text.plain或直接删掉<scope></scope>标签
多行模板中换行和缩进怎么写才不乱
XML 中的换行符和空格会被原样插入，所以你在<content></content>里写的缩进，会变成最终代码的前导空格。这不是 bug，是设计行为。
安全写法只有两种：
- 把整个
<content></content>内容写在一行内（可读性差但零风险），例如：<content><![CDATA[<div class="$1">$2</div>]]></content> - 用
包裹，并手动删除首尾换行：第一行紧贴<code><content></content>，最后一行]]>紧贴</content>，中间内容每行开头不要空格
别信“自动格式化”——Sublime 自带的 snippet 编辑器不会帮你清理缩进。写 React 组件或 HTML5 模板时，这点最容易翻车。
$1、${1:default} 和 $0 的实际行为差异
$1 是占位符，但单独用它不会高亮或提供编辑框；${1:console} 才会默认显示console并允许你直接修改；$0 必须且只能出现一次，代表最终光标停留位置。
几个关键细节：
- 多个
$1会同步变化，不是独立字段；真要复用同一值，写成${1:xxx}+${1} - 函数括号不能直接写
function $1() { $2 }，XML 解析器会把()当标签，得写成function ${1:name}() { $2 } - 内置变量如
$TM_FILENAME_BASE、$CURRENT_YEAR只在内有效，外面写无效
复杂模板（比如带 props 的 Vue 组件）一旦嵌套层级变深，$1～$9 的顺序和默认值设置稍有偏差，插入后光标就卡住或跳错位置——建议先写最简版本，再逐步加字段。
