掌握VSCode片段变量可提升开发效率，实现智能补全：$TM_FILENAME、$TM_DIRECTORY等插入文件信息，$CURRENT_YEAR、$CLIPBOARD填充时间与剪贴板内容，$SELECTION处理选中文本；通过${index:variable}设置占位符，结合正则变换${var/regex/format/flags}实现如文件名转PascalCase；利用$TM_DIRECTORY和正则提取路径生成相对导入或路由，打造上下文感知的动态代码片段。
在 vscode 中编写代码片段（snippets）时，变量是实现动态、智能补全的核心。它们不仅能插入静态文本，还能根据编辑上下文自动填充文件名、选择内容、时间戳等信息。掌握这些变量的用法，能极大提升开发效率，实现上下文感知的动态片段创作。
基础内置变量
VSCode 提供了一系列开箱即用的全局变量，适用于大多数语言环境：
- $TM_FILENAME：当前打开文件的文件名，包含扩展名。
- $TM_DIRECTORY：文件所在目录的完整路径（不带尾斜杠）。
- $TM_LINE_INDEX：当前光标所在行的索引（从0开始）。
- $TM_LINE_NUMBER：当前行号（从1开始），适合日志或注释标记。
- $CLIPBOARD：系统剪贴板的内容，可用于快速粘贴外部文本。
- $CURRENT_YEAR、$CURRENT_MONTH、$CURRENT_DATE：插入当前日期相关值，常用于版权注释。
- $SELECTION：用户选中的文本内容，若无选择则为空。
例如，创建一个版权注释片段：
"copyright": {"prefix": "copy",
"body": [
"// Copyright (c) $CURRENT_YEAR $CLIPBOARD"
]
}
输入 copy 后，会自动插入年份和你复制的公司名。
占位符与条件变量
片段变量常嵌套在占位符中，格式为 ${index:variable} 或 ${index:variable:default}。
- $1、$2：制表位（Tab Stop），按 Tab 键可依次跳转。
- ${1:label}：带默认值的占位符，被用户编辑后默认值消失。
-
${TM_SELECTED_TEXT}：与
$SELECTION类似，专用于包裹选中文本的场景。
比如将选中变量包裹成日志输出：
"log": {"prefix": "log",
"body": "console.log('${TM_SELECTED_TEXT:$1}');"
}
有选中内容时，直接包围；无选中则留出输入位置。
正则变换：高级上下文处理
最强大的功能之一是使用正则表达式对变量进行转换：${variable/regex/format/flags}。
-
regex：匹配模式，支持捕获组（如
(w+)）。 -
format：替换模板，用
$1、$2引用捕获组。 -
flags：可选
i（忽略大小写）、g（全局替换）等。
示例：将文件名转为 PascalCase 组件名：
"prefix": "cname",
"body": "${TM_FILENAME/(.*)\.(?:jsx?|tsx?)/${1:/capitalize}/}"
}
若文件名为 user-list.js，插入结果为 User-list（注意 capitalize 只改首字母）。
更进一步，可用多个捕获组重构命名：
"${TM_FILENAME/(.*)_test\.js/${1}:test/}"把 math_test.js 转为 math:test，适合测试标签场景。
上下文感知片段设计技巧
真正“智能”的片段需结合语境。虽然 VSCode 不支持在 JSON 片段中写逻辑判断，但可通过变量组合模拟上下文行为。
- 利用
$SELECTION实现“有选中则处理，否则提示输入”。 - 通过文件路径变量
$TM_DIRECTORY判断项目结构，生成相对导入路径。 - 用正则提取路由路径：基于文件夹名生成 API 路由字符串。
例如，在 React 项目中自动生成组件导入：
"importComp": {"prefix": "imp",
"body": "import ${1:Component} from '${RELATIVE_FILEPATH/^.+\/src\/(.+?)\.tsx?$/$1/}';"
}
从深层组件文件生成简洁导入路径，减少手动调整。
基本上就这些。熟练运用 VSCode 的片段变量，能让代码补全不再是简单的文本替换，而是具备上下文理解能力的辅助工具。关键在于多尝试正则变换，并结合实际项目结构定制专属片段。
