sublime text 中 tab 键自动补全 snippet 需同时满足路径（仅 packages/user/）、触发器（无空格/点号）、作用域（匹配当前语法）和设置（tab_completion 为 true 且无插件劫持）四重条件。
Tab 键在 Sublime Text 里默认不补全，而是插缩进或触发弹窗——想让它自动补全 snippet（比如输入 log 按 Tab 补成 console.log(${1:msg});），必须同时满足路径、触发器、作用域和设置四重条件，缺一不可。
Snippet 文件必须放在 Packages/User/ 目录下
Sublime 只从固定路径加载 snippet：Packages/User/ 是唯一能被用户直接写入且保证生效的位置。丢在桌面、项目目录或任意子文件夹都不行。
- Windows 路径：
%APPDATA%\Sublime Text\Packages\User\ - macOS 路径：
~/Library/Application Support/Sublime Text/Packages/User/ - Linux 路径：
~/.config/sublime-text/Packages/User/
文件名随意（如 console-log.sublime-snippet），但后缀必须是 .sublime-snippet，内容需为合法 XML 格式，且 <tabtrigger></tabtrigger> 内不能含空格或点号（<tabtrigger>log</tabtrigger> ✅，<tabtrigger>console.log</tabtrigger> ❌）。
tab_completion 必须为 true，且未被插件劫持
这个开关控制「Tab 是否参与文本补全」，包括 snippet 和单词补全。它和 auto_complete 是两套逻辑：后者管弹窗，前者管 Tab 键行为。
- 检查用户设置（
Preferences → Settings – User）中是否有："tab_completion": true（默认是true，但插件可能覆盖） - 如果装了 Emmet，它默认接管 HTML/CSS 的 Tab 行为；需在 Emmet 设置中关闭
"enable_tab_abbreviations_for_scopes"，或限定 scope 白名单 - 如果
auto_complete为true且补全框已弹出，按 Tab 会选中高亮项而非触发 snippet——此时先按Esc关闭弹窗再试
<scope></scope> 必须匹配当前文件语法
Snippet 的 <scope>source.js</scope> 不是可有可无的注释，而是硬性过滤条件。写错 scope 就等于禁用该 snippet。
- 常见 scope 示例：
source.python（.py）、source.js（.js）、text.html.basic（.html） - Vue 单文件组件的
<script></script>块常被识别为text.html.basic，导致 JS snippet 不生效；点右下角语法名手动切到JavaScript或Vue Component（如有对应插件） - 验证方法：打开目标文件 → 输入 trigger 文本（如
log）→ 按Ctrl+Space，若 snippet 出现在列表中（通常标为 “Snippet” 类别），说明 scope 正确；否则需修正
补全不生效？优先排查这三处静默覆盖
最常被忽略的是配置被更高优先级规则覆盖，且不报错、不提示：
-
detect_indentation为true（默认值）时，它不仅影响缩进，还会干扰 Tab 行为：一旦检测到文件开头有\t，就强制将translate_tabs_to_spaces设为false，间接导致 snippet 补全失败（尤其在混用空格和 Tab 的旧文件中）——务必在用户设置中加"detect_indentation": false - Python 文件受语言包自带
Python.sublime-settings硬编码约束（默认"tab_size": 2+"translate_tabs_to_spaces": false），会屏蔽全局设置；必须通过Preferences → Settings – Syntax Specific单独配"tab_size": 4和"translate_tabs_to_spaces": true -
trim_automatic_white_space若为true，保存时会删末尾空格，可能破坏 snippet 中的占位符格式（如${1:msg}后多一个空格被删，导致补全错位）；建议设为false或改用更安全的trim_trailing_white_space_on_save
真正起效的 Tab 补全，从来不是“配完就灵”，而是路径对、scope 对、开关开、覆盖关——四者齐备，log 才会在你按下 Tab 的瞬间变成完整语句。
