VSCode代码片段变量完全由编辑器原生支持，无需插件；高频变量包括$TM_FILENAME、$SELECTION、$CURRENT_DATE、$TM_CURRENT_LINE、$CLIPBOARD，各具特定行为与限制。
VSCode代码片段不依赖插件，变量靠内置语法实现
VSCode 的代码片段变量功能完全由编辑器原生支持，不需要安装任何插件。所谓“插件的模板变量”是个常见误解——所有变量（如$TM_FILENAME、${CURRENT_YEAR}）都来自 VSCode 自身解析引擎，插件最多是封装或增强触发逻辑，但无法新增或修改变量行为。
如果你在某个插件文档里看到自定义变量（比如$GIT_BRANCH），那通常是该插件自己注入的扩展能力，和 VSCode 原生命令无关，且不保证跨环境兼容。
必须掌握的 5 个高频内置变量及其坑点
这些变量在任意语言的 .json 片段文件中直接可用，但实际效果受上下文限制：
-
$TM_FILENAME：只返回文件名（含后缀），不含路径；想取不含后缀的用$TM_FILENAME_BASE -
$SELECTION：仅当有文本被选中时才生效，否则为空字符串；若 body 中多行使用，它不会自动重复填充 -
$CURRENT_DATE：格式固定为YYYY-MM-DD，不能改成MM/DD/YYYY；需要自定义格式只能靠外部脚本+插件，原生不支持 -
$TM_CURRENT_LINE：插入的是光标所在**整行内容**，不是当前行号；行号要用$TM_LINE_NUMBER -
$CLIPBOARD：读取系统剪贴板，但 macOS 上可能因权限被静默截断；Windows/Linux 通常可靠
body 中变量与占位符混用时的执行顺序
VSCode 按「从上到下、从左到右」解析 body 数组每一项，但变量展开和占位符定位是两个独立阶段：
- 所有变量（
$xxx或${xxx}）在插入前一次性求值并替换 - 占位符（
${1:default}、$2、$0）在变量替换完成后才建立跳转链 - 错误写法：
"${1:$TM_FILENAME}"—— 这会导致$TM_FILENAME在用户编辑${1}时**不再更新**，它只是初始值 - 正确思路：变量用于上下文快照（如创建时间），占位符用于人工可编辑内容（如函数名、参数）
例如，一个安全的日志片段应写成："console.log('[${CURRENT_DATE} ${CURRENT_HOUR}:${CURRENT_MINUTE}]', ${1:msg});"，其中时间戳固化，${1:msg} 留给手动输入。
全局片段 vs 语言片段中变量的行为差异
变量本身无区别，但生效范围和潜在冲突点值得注意：
- 全局片段（
snippets.json）中定义的prefix会在所有语言中触发，但变量如$BLOCK_COMMENT_START在非注释敏感语言里可能为空 - 语言片段（如
javascript.json）能用更精准的变量，比如$TM_SCOPE可返回source.js，但这个值对普通用户基本无用 - 如果同一
prefix在全局和语言文件中都存在，语言片段优先级更高 —— 这容易导致你改了全局文件却没生效 -
scope字段只在全局片段文件中有效，用于限制某片段仅在指定语言中出现；但它不能启用新变量，只是过滤触发场景
真正容易被忽略的是：变量值取决于「片段插入瞬间」的编辑器状态，而不是定义时刻。比如你在空文件里触发片段，$SELECTION 就是空；但如果你先选中一段文本再触发，它就带值——这个动态性没法预判，只能靠提示语或文档说明。
