VSCode代码段变量需按上下文使用：TM_FILENAME始终可用，TM_FILENAME_BASE仅文件已保存时有效，TM_SELECTED_TEXT需先选中文本，CLIPBOARD跨平台兼容性不同；触发依赖语言ID而非扩展名；占位符为静态快照，不支持动态更新。
VSCode 自定义代码段里，TM_FILENAME_BASE 和 TM_SELECTED_TEXT 这类变量不是“写完就能用”的魔法符号——它们只在特定上下文生效，且大小写、拼写错一个字母就彻底失效。
snippets JSON 里哪些变量真能用？
VSCode 官方文档列了十几种内置变量，但实际可用性取决于触发时机和编辑器状态。比如：
-
TM_FILENAME：当前文件完整名（含扩展名），任何时候都可用 -
TM_FILENAME_BASE：仅当文件已保存（有真实路径）时才展开；新建未保存的 Untitled-1 文件里它为空字符串 -
TM_SELECTED_TEXT：必须先选中文本，再触发代码段（比如按Ctrl+Shift+P→ “Insert Snippet” 或用快捷键），否则留空 -
CLIPBOARD：读取系统剪贴板，但 macOS 上需额外授权，Windows/Linux 通常直接可用
别硬记，打开命令面板运行 Preferences: Configure User Snippets，选语言后 VSCode 会自动补全常用变量提示——那是最准的参考。
触发词（prefix）为什么输对了也不弹？
触发词不生效，90% 是因为语言模式没对上。VSCode 的代码段是按语言 ID 绑定的，不是按文件扩展名。
- 新建一个
.py文件，左下角显示 “Python”，说明语言模式正确 →python.json里的 snippets 才会加载 - 如果左下角显示 “Plain Text”，哪怕文件叫
index.js，javascript.json的 snippets 也完全不会响应 - 手动切换语言模式：按
Ctrl+Shift+P→ 输入 “Change Language Mode”，选对应语言 ID（注意不是 “JavaScript React”，而是纯javascript）
验证方式：在代码段里加个明显占位符，比如 "body": ["// lang=${TM_LANGUAGE}"]，触发后看输出是不是你预期的语言 ID。
如何让占位符支持“输入即更新”而不是静态快照？
VSCode 的变量（如 $TM_FILENAME_BASE）都是插入瞬间求值的快照，没法动态响应后续编辑。真要实现“改文件名，代码段里变量跟着变”，得换思路：
- 用
${1:default}定义可跳转编辑的占位符，把变量值预填进去，人工确认/修改 - 搭配扩展如
Auto Rename Tag或自定义命令（workbench.action.terminal.sendSequence）做联动，但超出 snippets 能力范围 - 接受现实：snippets 本质是模板工具，不是响应式框架。需要强动态性，该用脚本生成文件，而不是死磕 JSON 配置
常见误操作是写 ${TM_FILENAME_BASE} 当成 Vue 的 {{ fileName }} 用——它不会监听变化，只管插一次。
多光标 + 占位符嵌套时的顺序和焦点控制
多个 $1、$2 同时出现时，焦点移动顺序严格按数字升序，但容易被 ${1:xxx} 和 ${2:yyy} 的默认值干扰：
- 如果
$1有默认值（如${1:props}），用户 Tab 进来时看到的是 “props”，删掉才真正开始输入 - 想让第一个焦点落在空输入态？写成
${1:}，别省略冒号后的空内容 - 需要两个位置同步输入相同内容？用
${1:default}和${1}（第二个不带默认值），VSCode 会自动同步编辑 - 嵌套占位符不支持，比如
${1:${TM_FILENAME_BASE}}会原样输出字符串，不会二次展开
复杂逻辑别堆在 snippets 里——它没条件判断、没函数调用，只有线性占位和静态变量。越想让它聪明，越容易卡在 Tab 键失灵或光标乱跳上。
