vscode代码片段不生效的主因是语言id不匹配、json格式错误或未重启编辑器；必须确保右下角语言模式与snippet文件名及scope字段完全一致，body为字符串数组，且修改后需重启vscode。
VSCode 代码片段（Snippets）不是“智能补全”，也不是 AI 生成，它就是一个精准触发、严格匹配、零容错的静态模板插入机制——写错一个逗号、语言 ID 对不上、文件没保存、编辑器没重启，prefix 就永远不出现。
为什么输入 log 却没反应？检查三个硬性条件
VSCode 不会“猜你想用哪个片段”，它只做三件事：确认当前文件的语言 ID 是否匹配片段作用域、读取 JSON 是否合法、检查 prefix 是否在有效上下文中被输入。漏掉任一环，就静默失败。
- 右下角语言模式必须是准确 ID：比如
App.tsx文件要触发 TypeScript React 片段，状态栏必须显示 TypeScript React，而不是Plain Text、JavaScript React或Vue；可按Ctrl+Shift+P→ 输入Developer: Inspect Editor Tokens and Scopes查看真实languageId - 片段文件名必须和语言 ID 完全一致：
typescriptreact.json✅，tsx.json❌，react.json❌，javascript.json在 .ts 文件里也 ❌ - 未保存的临时文件（如
Untitled-1）不加载任何用户级片段，哪怕你配得再完美
body 必须是字符串数组，不是字符串，也不能带
body 字段表面看是“放代码的地方”，实则是 VSCode 解析逻辑最脆弱的一环。它不接受单个字符串，也不接受含换行符
的字符串，必须拆成每行一个元素的数组。
- ❌ 错误写法：
"body": "console.log($1);\n$0"或"body": ["console.log($1);\n$0"] - ✅ 正确写法：
"body": ["console.log($1);", "$0"]—— 换行靠数组元素自然分隔 - 缩进必须手动写死在字符串里：
"body": ["function ${1:name}() {", " return $2;", "}"]，其中空格不能替换成\t，VSCode 不解析制表符语义 - 忘记转义双引号会导致整个 JSON 解析失败，例如：
"body": ["const a = "${1:value}";"]✅，漏掉反斜杠就崩
scope 字段不是可选项，而是生效开关
很多人以为不写 scope 就是“全局可用”，其实恰恰相反：scope 缺失或为空，等价于 "scope": ""，只在 languageId 为空的上下文中触发——现实中几乎不存在。
- 想让片段在
.ts和.tsx文件都生效，必须显式写："scope": "typescript,typescriptreact"（注意：逗号后不能有空格） - 想在
.vue文件的<script></script>区块生效，需配"scope": "javascript,vue"，且片段文件得是vue.code-snippets或放在.vscode/snippets/vue.json - 全局片段（如
common.code-snippets）若没加scope，默认不会在任何已识别语言的文件中触发 - 工作区级片段（
.vscode/snippets/xxx.json）天然绑定语言 ID，无需额外scope，优先级高于用户级，更适合项目专用结构
改完 snippets 文件后，必须重启 VSCode 才能生效
VSCode 只在启动时加载一次 snippets 目录下的 JSON 文件。编辑保存后不重启，旧配置照常运行——这是最常被忽略的硬性限制，也是“明明改对了却没变化”的根本原因。
- 修改
javascript.json或common.code-snippets后，执行Developer: Reload Window不够，部分版本仍缓存旧结构；稳妥做法是完全关闭窗口再重开 - 已打开的文件可能维持旧语言上下文，关掉再重开该文件更可靠
- 团队共享时，把
.vscode/snippets/typescriptreact.json提交到 Git，新人拉完代码后必须重启 VSCode 窗口，否则看不到rfc、useEffect等前缀 - 变量如
$CURRENT_YEAR或$TM_FILENAME_BASE依赖上下文，如果片段本身没加载，这些变量根本不会求值
真正卡住人的从来不是语法多难，而是语言 ID 大小写是否一致、JSON 是否多了一个逗号、右下角状态栏有没有悄悄变回 Plain Text —— 这些细节不逐项验证，再好的模板也等于没写。
