自定义代码片段可通过内置变量、占位变量和格式化处理提升效率:使用$TM_FILENAME等获取上下文信息,$1、$2定义可编辑占位符,支持默认值与嵌套,结合正则格式化实现智能输出,如文件名转驼峰命名,注意变量拼写、转义及CDATA包裹多行内容,保存后需重启生效。

在 Sublime Text 中,自定义代码片段(Snippet)时使用变量可以大幅提升编码效率。这些变量不仅能动态填充内容,还能结合上下文自动识别文件名、时间、选中文字等信息。
内置变量:直接使用,无需定义
Sublime 提供了一些开箱即用的内置变量,可在任何 snippet 中直接引用:
- $TM_FILENAME:当前文件的完整文件名(含扩展名)
- $TM_FILEPATH:文件的完整路径
- $TM_DIRECTORY:文件所在目录路径
- $TM_LINE_NUMBER:光标所在行号
- $SELECTION:用户选中的文本(可用于包裹式片段)
- $CURRENT_YEAR、$CURRENT_MONTH、$CURRENT_DATE:当前年月日
- $BLOCK_COMMENT_START、$BLOCK_COMMENT_END:根据语言自动插入块注释符号
例如,在 JavaScript 注释片段中这样写:
自定义占位变量:支持层级与默认值
你可以通过 $1、$2... 定义可跳转的编辑点,其中数字代表 Tab 键顺序,$0 是最终退出位置。这些“变量”也支持嵌套和默认值:
- ${1:default}:第1个编辑点,显示默认值 "default"
- ${2:className}:提示输入类名
- ${1:this is ${2:nested}}:支持嵌套结构,先编辑外层再进入内层
示例:HTML 类属性片段
class="${1:mt-${2:4} mb-${3:4}}"$0插入后光标位于 class 内部,按 Tab 可依次修改 margin 值。
环境变量与格式化技巧
除了基本变量,还可对变量进行格式化处理,实现更智能的输出:
- ${TM_FILENAME/(.*)\\..+/$1/}:正则提取文件名(不含扩展名)
- ${CURRENT_MONTH/%m/.}/:将月份格式化为带前导零的数字
- ${SELECTION/^(\s*)|(\s*)$/$1$2/}:去除选中文本首尾空格后再插入
比如创建一个以文件名命名的 React 组件:
const ${TM_FILENAME/(.*)\\..+/${1:/capitalize}/} = () => {\n return $0;\n};若文件名为 header.js,插入后自动变为 Header。
实用建议与注意事项
编写 snippet 变量时注意以下几点能避免常见问题:
- 确保变量名正确拼写,如 $TM_SELECTED_TEXT 已废弃,应使用 $SELECTION
- 正则替换语法为 ${VARIABLE/pattern/format/flags},斜杠需转义
- 多行内容建议用 包裹,避免 XML 解析错误
- 测试片段时保存后重新打开文件或重启 Sublime 才会生效
基本上就这些。合理利用变量能让 snippet 真正“活”起来,减少重复输入,贴合实际开发场景。










