打造属于你的Sublime专属代码片段Snippet

Sublime Text 的代码片段（Snippet）功能，用好了能极大提升编码效率。但很多人在配置时，都会遇到“写好了却用不了”的尴尬。今天就把几个最容易踩坑的地方拆开来讲，希望能帮你一次搞定，省去反复试错的麻烦。

作用域对不上，片段写再好也白搭

你精心写了一个 log 片段，满心期待敲下 log 然后按 Tab，结果没反应。别急着怀疑人生，大概率不是代码写错了，而是作用域没对上。

Sublime 的 Snippet 默认只在当前语法高亮类型匹配时才激活。换句话说，一个在 Python 文件里能用的片段，你不会希望它在纯文本文件里冒出来。这就要靠 标签来指定。

• source.python：只限 Python 文件。
• text.html.basic：针对 HTML（注意 Sublime 6+ 之后，默认作用域是 text.html.basic，不是 text.html）。
• source, text：覆盖所有源码和文本文件，但得小心，用得太宽容易误触。

一个小技巧：按 Ctrl+Shift+P，搜索 Developer: Show Scope Name，这时光标所在位置的作用域就会直接显示在状态栏。用这个办法，一步就能查清楚当前文件到底该用什么作用域。

Tab 没反应？看看是不是这几点没注意

作用域写对了，但按 Tab 还是没动静？那问题大概率出在触发词、命名或者插件冲突上。

• 触发词（tabTrigger）：必须全小写，不能有空格，也不能含点号。像 console.log 这种写法会直接失效，改成 conlog 才行。
• 插件打架：装过 Emmet、TabNine 这类自动补全插件的朋友要注意，它们有时候会抢 Tab 键的响应。可以临时禁用这些插件来做个测试，看看到底是谁在拦截。
• 文件路径：片段文件必须放在 Packages/User/ 目录下，后缀名是 .sublime-snippet。Sublime 不会递归查找子文件夹，所以千万别自作主张把它放到深层目录里。
• 保存确认：修改完后不需要重启，但一定要确认文件已正确保存。状态栏显示 UTF-8 且没有红色波浪线报错，才算稳妥。

占位符和默认值，写错格式会让你怀疑人生

$1、$2、${1:default} 这些变量占位符，是用来控制光标跳转和默认值的利器，但它们也是有严格格式的。

• $1 到 $9 控制光标跳转的先后顺序，$0 是最终光标停靠的位置。
• ${1:hello} 的意思是：第一个跳转点，默认给你填上 hello，但你可以直接编辑。而 ${1:} 则是空默认值，光标会直接停在这里等你输入。
• 稍微高级一点的用法：如果你在片段里把 $1 写了两次，比如
  $1
  ，那么你输入一次内容，两边的占位符会同步更新。这对成对标签来说，特别顺手。
• 千万注意，别在同一个片段里混用 $1 和 ${1:text}，Sublime 会优先按编号处理，结果很容易导致光标跳转次序错乱，体验大打折扣。

实战：写一个 React 函数组件 Snippet

不少 React 开发者遇到过：rfc 片段在 .js 文件里用得好好的，换了 .jsx 或 .tsx 就失灵了。原因还是作用域的问题。

• JSX 文件的作用域通常是 source.js.jsx，TSX 是 source.tsx。为了覆盖全面，可以写成：source.js.jsx, source.tsx, source.js。
• 示例片段头可以这样写：rfcsource.js.jsx, source.tsx。
• 在 body 里，我建议用 export default ${1:ComponentName} = () => { $2 }; 这种写法，更符合现代 React 组件的风格，而不是写死 export default function。
• 最后，别忘了加上 React Function Component，这样鼠标悬停时能看到明确提示，团队协作时也方便别人理解。

作用域和触发词的组合，的确需要花点时间调试。但一旦配准，之后每次复用都只需要敲一下 Tab 键——成本极低，收益可观。真正棘手的是跨语法复用（比如 Vue 和 React 里都想用一个通用的 log 片段），这种场景没有捷径，只能拆成多个独立的片段，各自绑定不同的作用域。按需配置，就是最可靠的解法。