Sublime Text 代码块生效需满足三要素：.sublime-snippet 文件必须置于 Packages/User/ 目录下，scope 必须匹配当前文件语法（如 source.js），且 <content> 需用 <![CDATA[...]]> 包裹；任一条件不满足则 tabTrigger 无响应。

Sublime Text 插入常用代码块，核心就一条：用 .sublime-snippet 文件 + 正确路径 + 匹配 scope。放错位置、作用域写错、XML 闭合不严，三者任一出问题，tabTrigger 就完全没反应。

Snippet 文件必须放在 Packages/User/ 目录下才生效

Sublime 不会扫描任意目录下的 .sublime-snippet 文件。桌面、项目根目录、甚至 Packages/ 下其他子目录（比如 Packages/JavaScript/）都不行。

• Windows 路径：%APPDATA%\Sublime Text\Packages\User\
• macOS 路径：~/Library/Application Support/Sublime Text/Packages/User/
• Linux 路径：~/.config/sublime-text/Packages/User/

最稳的方式是菜单栏点击 Preferences → Browse Packages…，直接打开该文件夹再保存。别手抖点错位置，也别用中文路径或带空格的文件名——部分 Sublime Text 4 版本会静默跳过加载。

scope 写错是“输完不触发”的头号原因

比如你写了 <scope>source.js</scope>，但当前文件右下角显示的是 Plain text 或 HTML，那无论你输多少遍 log + Tab，都不会展开。这不是 snippet 坏了，是它压根没被激活。

• 检查底部状态栏语法标识，右键编辑区 → Set Syntax → JavaScript（或对应语言）
• 常见 scope 值：source.js、source.jsx、text.html.basic、source.css
• 想全局生效？可以删掉 <scope> 标签，但容易和 Emmet 或其他 snippet 冲突，慎用

<content> 必须用 <![CDATA[...]]> 包裹

JS 里有 {、}，HTML 里有 <、>，不加 CDATA 会导致 XML 解析失败，整个 snippet 加载失败且无报错提示。

另外，<content> 内的换行和缩进会被原样插入。例如：

<![CDATA[
function $1() {
  $2
}
]]>

实际展开后，第二行会有 2 个空格缩进。如果不想缩进，就顶格写；如果想控制缩进，用空格对齐，别用 Tab 键——Tab 在 snippet 编辑时会被解释为占位符跳转符。

光标跳转用 $1、$2，别用 ${1:default} 过度设计

$1 是第一个可编辑位置，按 Tab 跳到 $2，再按跳到 $0（最终停留位）。这是最轻量、最稳定的做法。

• 想设默认值？${1:console.log} 可以，但注意：一旦用户修改了这个字段，后续 $2 的位置可能因内容长度变化而偏移
• 避免嵌套占位符，比如 ${1:${2:text}} —— Sublime 不支持，会解析异常
• 多行结构中，$0 推荐放在最后一行末尾，方便插入后直接回车或分号

真正容易被忽略的不是怎么写，而是每次改完 snippet 后，得关掉再重开当前文件，或者切换一下语法（比如从 JS 切成 Plain text 再切回来），才能让新定义的 tabTrigger 生效——Sublime 不自动热重载 snippet 文件。