Sublime中代码片段生效需满足三个硬条件：文件名必须为.sublime-snippet后缀、保存在Packages/User/目录下、作用域正确（如source.js）；按Tab无反应通常因未加载文件而非软件故障。

Sublime 里没有“一键生成代码片段”这回事——你真正需要的，是“写好一个 .sublime-snippet 文件，保存到正确位置，再在对应语法文件里输触发词 + Tab”。所谓“一键”，只是错觉；生效与否，全看三个硬条件：后缀名、路径、scope。

为什么写完 snippet 按 Tab 没反应？

最常见原因不是 Sublime 坏了，而是它根本没加载这个文件。静默失败，不报错也不提示。

• 文件名不是 .sublime-snippet 后缀（比如存成 log.snippet 或隐藏了 .txt，实际是 log.sublime-snippet.txt）
• 没放在 Packages/User/ 目录下（用 Preferences → Browse Packages… 打开的才是对的路径）
• 写错了：JS 文件作用域是 source.js，不是 javascript 或 js；Vue 的 <script></script> 块是 source.js.vue，不是 source.vue
• 当前文件右下角显示的是 Plain Text，没设语法类型， 全部失效

怎么快速建一个可用的 snippet？

别手写 XML，用 Sublime 自带命令生成骨架，改两行就跑起来。

昇思MindSpore

昇思MindSpore是一款AI学习资源工具，华为开源的自研AI深度学习框架。

下载

• 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Tools: New Snippet 回车
• 把 里的占位内容换成你要的代码，比如：console.log(${1:msg});$0
• 填 ，只用小写字母和数字，比如 log；不能有空格或 -
• 填 ，查当前作用域最快方式是 Ctrl+Shift+P → Developer: Show Scope Name
• 保存为 log.sublime-snippet，路径必须是 Packages/User/

如何让 snippet 支持多语言或动态内容？

靠 多值和内置变量，但别指望它像模板引擎那样渲染逻辑。

• 多语言支持：用英文逗号分隔多个 scope，例如 source.js,source.ts,source.jsx
• HTML 中的 div 片段要配 text.html.basic，不是 html
• 想自动插入当前文件名？用 $TM_FILENAME_BASE，比如 export default ${1:$TM_FILENAME_BASE};
• 想包裹选中文本？用 $SELECTION，比如 $SELECTION，但必须先选中文字再触发
• 所有变量大小写敏感，且不支持嵌套，${TM_FILENAME%.*} 这类 Shell 截断会直接失效

容易被忽略的关键细节

很多人卡在最后一步：以为写对了就能用，结果反复重启、重装插件，其实问题藏在最基础的地方。

• $1 和 $2 必须连续编号，漏掉 $1 只写 $2，Tab 跳转会乱
• $0 必须出现且只能出现一次，它是最终光标落点，不是跳转位
• 里的代码必须用 包裹，否则 、& 会被 XML 解析器吃掉
• 多个 snippet 用了同一个 ，Sublime 只加载文件名 ASCII 排序最大的那个，不会合并也不会警告
• 改完 snippet 文件后，不用重启 Sublime，但得确保当前文件语法类型已正确设置，否则 scope 不匹配就是白忙