VSCode自定义代码片段输入prefix无反应，主因是语言模式不匹配、body未用字符串数组、文件名或路径错误；必须确保当前文件语言ID与snippet文件名（如javascript.json）一致，body为["line1","line2"]格式，且文件编码为UTF-8无BOM。
VSCode 自定义代码片段不是“配完就能用”，关键在于文件位置、JSON 结构、语言上下文三者必须严丝合缝，缺一不可。
为什么输入 prefix 没反应？检查 language mode 和文件名是否对得上
VSCode 的 snippet 不是全局监听器，它只在当前编辑器的语言模式（右下角显示的 javascript、typescriptreact、vue 等）下激活。常见失效原因：
-
javascript.json文件写的 snippet，在一个.ts文件里不会触发——TypeScript 需要typescript.json或显式加"scope": "typescript" -
vue.json对应的是 Vue 单文件组件（SFC），但如果你装了 Volar 插件，实际语言 ID 可能是vue-html或vue，得看右下角状态栏显示的确切名称 - 文件名写成
js.code-snippets或my-snippets.js→ VSCode 只认.json后缀，且必须和语言 ID 完全一致 - 当前文件是
Plain Text模式 → 点击右下角手动切换为对应语言
body 必须是字符串数组，不是单个字符串
这是最常静默失败的点：VSCode 不报错，但 snippet 就是不展开。根本原因是 JSON 校验通过了，但语义不合法。
- 错误写法：
"body": "console.log($1);"→ 缺少数组包装，整个 snippet 被忽略 - 正确写法：
"body": ["console.log($1);"] - 多行结构每行单独一项：
"body": ["function $1() {", "\t$0", "}"]，缩进用空格（非 Tab），换行靠数组元素自然分隔 - 要插入真实美元符，写成
$$；$0是最终光标位，${1:name}是带默认值的可编辑占位符
全局 vs 语言级 vs 工作区级：作用域选错等于白配
三种路径对应不同生效范围，混用会导致预期外的行为：
- 全局 snippet：放在
$HOME/Library/Application Support/Code/User/snippets/（macOS）或对应系统路径，文件名任意，如common.code-snippets，所有语言都可触发（除非加scope限定） - 语言级 snippet：通过命令面板选
javascript，生成javascript.json，只在 JS 文件中生效；若想跨 JS/TS，得写"scope": "javascript,typescript" - 工作区级 snippet：在项目根目录建
.vscode/snippets/javascript.json，仅对该文件夹有效，适合团队统一模板（比如强制用pxToRem()而非px） - 注意：
.vscode/snippets/下的文件名也必须是语言 ID，比如typescriptreact.json才能在.tsx里触发
UTF-8 无 BOM + 逗号结尾：两个隐蔽但致命的格式细节
VSCode 不提示 JSON 错误，但只要这两点出问题，snippet 就彻底失活：
- Windows 下用记事本保存 JSON，默认带 BOM → 用 VSCode 自己另存，编码选
UTF-8（不是UTF-8 with BOM） - 最后一个字段后多写逗号（如
"description": "log",后面还跟了个,）→ 整个文件解析失败，snippet 不加载 - 验证方法：删掉文件内容，只留
{}，保存；再一行行加字段，每加一次就试一次触发，快速定位哪行崩了 - 别依赖扩展自动补全来验证 snippet 是否生效——先关掉 Prettier、ESLint 等可能劫持 Tab 行为的插件，纯原生环境测试
真正卡住人的从来不是语法本身，而是语言模式没匹配、body 少了一对方括号、或者文件编码藏了个看不见的 BOM。配 snippet 前，先盯住右下角那个小标签——它说了算。
