最常见原因是vscode未重载配置，仅启动时读取一次snippets文件；其他高频原因包括语言模式不匹配、临时文件不生效、prefix含非法字符、scope格式错误或languageid不准确。
为什么输入了 prefix 却没反应？
最常见原因是 VSCode 没有重新加载 snippets 配置。它只在启动时读取一次 javascript.json 或 my-common.code-snippets 文件，改完不重启编辑器，修改完全无效。
其他高频原因包括：
- 当前文件右下角语言模式不是
javascript（比如显示的是JavaScript React或typescript），而你的片段只配了"scope": "javascript" - 使用了未保存的临时文件（如
Untitled-1），用户片段默认不在此类上下文中生效 -
prefix含点号、空格或特殊符号（如"console.log"❌），VSCode 只接受纯字母/数字/下划线组成的字符串，且大小写敏感 -
scope字段值格式错误：逗号后不能有空格（"javascript, typescript"❌ → 必须是"javascript,typescript"✅）
如何正确设置 scope 字段让片段跨语言生效？
scope 不是可选项，而是决定片段是否加载的开关。不写 scope 的全局片段，默认等价于 "scope": ""，几乎从不触发。
想让一个片段同时在 .js 和 .ts 文件中可用，必须显式声明：
{
"Log to Console": {
"prefix": "log",
"scope": "javascript,typescript",
"body": ["console.log('$1');", "$2"],
"description": "Log output to console"
}
}
注意：scope 值必须与 VSCode 内部使用的 languageId 完全一致。查真实值的方法是：按 Ctrl+Shift+P → 输入 Developer: Inspect Editor Tokens and Scopes → 看弹窗中 languageId 字段。
常见误区：
- 写
"tsx"或"typescript,tsx"❌ —— 正确是"typescriptreact" - 以为
"scope": "html"能在.vue中生效 ❌ ——.vue的 script 块 languageId 是javascript或typescript，需单独配置
body 写法错在哪？为什么插入内容总是不对？
body 必须是字符串数组，每项代表一行代码；不能用 \n 拼接成单个字符串。
错误写法：
"body": "console.log($1);\n$0"
正确写法：
"body": ["console.log($1);", "$0"]
缩进必须硬编码在字符串里（比如用 2 个空格开头），\t 不会被自动识别为缩进。占位符也分行为：
-
$1：光标停靠点，无默认值 -
${1:default}：首次 Tab 会选中default文本，方便覆盖 -
$0：最终光标位置，不参与 Tab 跳转顺序
怎么验证当前配置是否真的被加载？
最直接的方式是打开命令面板（Ctrl+Shift+P），输入 Insert Snippet 并执行。如果列表里出现了你定义的片段名（如 Log to Console），说明配置已加载；若没出现，优先检查 JSON 格式是否合法、文件是否保存、编辑器是否重启过。
另一个信号是：在对应语言文件中输入 prefix 后，IntelliSense 提示列表里应出现该片段名称和 description。如果提示列表为空，大概率是 scope 不匹配或 languageId 错误。
真正容易被忽略的点是：VSCode 对 snippets 的加载极其“冷感”——它不会报错、不会提醒、不会热更新，错了一点就静默失效。每次改完，务必重启编辑器再测。
