VS Code代码片段：那些“不报错，但就是没用”的坑
直接改 JSON 文件根本不会生效
这里有个关键认知需要扭转：VS Code 的代码片段可不是那种“保存即生效”的实时配置。它的工作机制是，只在编辑器启动时，一次性加载 snippets 目录下的所有 JSON 文件。所以，当你兴冲冲地改完 ja vascript.json 或者 my-common.code-snippets 后，如果不重启编辑器，那么对不起，运行的依然是旧配置——这是导致大多数配置失效的头号元凶。
典型的翻车现场是什么样的呢？
你输入预设的 log，编辑器毫无反应；在补全列表里怎么也找不到刚加的新片段；明明修改了 body 内容，插进来的却还是老样子。
- 首先，确认一下当前文件右下角显示的语言模式是不是精确的
ja vascript。如果是Ja vaScript React或者typescript，那么专属于ja vascript的片段是不会被加载的。 - 其次，未保存的临时文件（比如
Untitled-1）几乎是个“法外之地”，不会触发任何用户自定义的代码片段。 - 最后，如果你把片段放在了全局文件
common.code-snippets里，却忘了加上"scope": "ja vascript"这个字段，那么即便在 .js 文件里，它也照样不会出现。
prefix 和 body 的写法容错率极低
prefix 和 body 这两个字段，看似简单直白，实则暗藏玄机，格式要求非常严格。prefix 必须是纯字符串，不能包含空格或特殊符号，而且大小写敏感。至于 body，它表面是个数组，但每一项都必须是独立的字符串，行与行之间的换行是靠数组元素来实现的，而不是在字符串里写 \n。
"prefix": "console.log"❌ —— 想什么呢？VS Code 根本不支持带点号的触发词，老老实实用log或者cl吧。"body": "console.log($1);\n$0"❌ —— 这是最常见的错误。正确写法是拆成数组：["console.log($1);", "$0"]。"body": ["function $1() {", " $0", "}"]✅ —— 注意，缩进必须用空格或制表符直接写在字符串里，\t在这里不会被自动识别为缩进。- 另外，
$1和${1:default}的行为有细微差别：后者在第一次按 Tab 键时，会直接选中default这个默认文本，而前者仅仅是把光标移到那个位置。
scope 字段不是可选项，而是生效开关
很多人对 scope 字段存在误解，以为不写就是“全局可用”。事实恰恰相反。对于全局片段文件（common.code-snippets），如果你不指定 scope，它的默认作用域就是空的，等价于 "scope": ""。这意味着它只会在 languageId 为空的上下文中触发——而这种场景几乎不存在。
- 想让一个片段同时在 .ts 和 .tsx 文件里生效？你必须明确写上：
"scope": "typescript,typescriptreact"。注意，是typescriptreact，不是tsx，也不是typescript,tsx。 - 如何查看当前文件的真实 languageId？按
Ctrl+Shift+P，输入Developer: Inspect Editor Tokens and Scopes，在弹出的窗口里找languageId字段的值。 "scope": "ja vascript, typescript"❌ —— 看，逗号后面多了个空格，这会导致整个字段被静默忽略，片段直接失效。- 对于项目专用的代码结构（比如用
rc快速生成一个 React 组件），更可靠的做法是使用工作区级片段，放在.vscode/snippets/ja vascript.json里，这比依赖全局片段加scope要稳定得多。
变量不是万能的，依赖上下文才有效
$TM_FILENAME_BASE、$CLIPBOARD、$TM_SELECTED_TEXT 这些内置变量看起来很方便，但它们各自都有严格的生效前提。只要用错一个字母，或者时机不对，返回的就是一个空字符串。
$TM_FILENAME_BASE在未保存的文件里是空的，只有文件已经保存为类似foo.js后，它才会展开为foo。$TM_SELECTED_TEXT要求你必须先选中一段文本，然后再触发代码片段，否则插入的就是空字符串。这个变量非常适合用来做文本包裹操作（比如给选中的代码加个try/catch），但不能把它当作一个通用的变量来随意使用。$CLIPBOARD的稳定性因系统而异：在 macOS 上可能受权限限制，Linux 下可能依赖xclip这类工具，Windows 平台通常比较稳定。- 最后记住，所有变量都必须用大括号包裹起来：
${TM_FILENAME_BASE}✅，$TM_FILENAME_BASE❌。
说到底，真正让人头疼的从来不是语法本身有多复杂，而是 VS Code 对 JSON 格式、languageId、文件状态这些前置条件的“静默处理”策略——它不报错，只是默默地跳过了你的配置。所以，每次修改完代码片段，最保险的做法就是：重启编辑器，然后在一个已经保存好的、对应类型的文件里实际测试一下。别相信“理论上应该可以”，实践才是检验真理的唯一标准。
