VSCode代码片段按作用域分层加载且严格匹配languageId；失效主因是global/language/workspace三级配置混用、languageId不匹配（如tsx文件实际为typescriptreact）、JSON格式错误（body非数组、尾逗号、变量未包裹等）。
VSCode 的代码片段不是“写完就生效”，而是按作用域分层加载、按语言 ID 精确匹配。多语言项目里片段失效，90% 是因为混用了全局、语言级、工作区三级配置，且没对齐真实的 languageId（比如 typescriptreact ≠ tsx）。
区分 global、language-specific、workspace 三类文件位置和加载优先级
VSCode 不会合并多个同名片段，它按“最具体优先”原则选取：工作区级 > 语言级 > 全局级。但这个“具体”不是看文件名，而是看当前编辑器的 languageId 是否与片段定义中的作用域完全一致。
- 全局片段存于
snippets/user.code-snippets（或你命名的common.code-snippets），无"scope"字段，默认所有语言都可能触发——但实际受editor.suggest.showSnippets和当前语言是否支持 snippet 提示控制 - 语言级片段必须通过
Preferences: Configure Language Specific Settings打开，选javascript就生成javascript.json，选typescriptreact就生成typescriptreact.json；该文件内直接写"snippets"对象，不嵌套在"[typescriptreact]"键下 - 工作区级片段需手动放至
.vscode/snippets/目录下，文件名任意（如project-a.code-snippets），但必须确保该路径存在且未被files.associations覆盖语言映射
为什么 .tsx 文件里 prefix 不触发？查清 languageId 才能配对
你在 .tsx 文件里敲 log 没反应，不是片段写错了，而是 VSCode 当前识别的 language ID 是 typescriptreact，而你把片段配在了 javascript.json 或写了 "scope": "tsx" ——后者根本不存在于内核语言列表中（monaco.languages.getLanguages() 输出不含 tsx）。
- 打开命令面板，执行
Developer: Inspect Editor Tokens and Scopes，看右上角显示的Language ID是什么（常见值：typescriptreact、javascript、python、jsonc） - 不要凭文件后缀猜，
.ts可能是typescript，.tsx多数是typescriptreact，但某些插件或定制版（如 OpenCode VS Code）可能映射为javascriptreact - 验证方式：在对应 language ID 的 JSON 文件中定义片段，保存后新开一个该类型文件测试，别复用旧标签页（缓存可能未刷新）
避免 body 数组格式错误导致整个片段静默失效
VSCode 对 snippet JSON 格式极其敏感，但几乎不报错——错了一处，整个文件的片段都不出现，且编辑器毫无提示。
-
body必须是字符串数组，不能是单个字符串：["console.log($1);", "$0"]✅，"console.log($1);\n$0"❌ - 每行 body 元素末尾不要加逗号（最后一项后不能有逗号），JSON 不允许尾随逗号
- 变量必须用大括号包裹：
${TM_FILENAME_BASE}✅，$TM_FILENAME_BASE❌（后者当普通文本插入） - 占位符编号不要重复：
$1出现两次会导致 Tab 跳转异常；$0建议显式写出，明确最终光标落点
跨语言复用逻辑时，用 global + scope 字段比复制多份更可靠
想让 log 片段在 javascript、typescript、typescriptreact 全部生效？别建三个文件各写一遍。在全局文件（如 common.code-snippets）中用 "scope" 字段声明支持的语言列表：
{
"Log to console": {
"prefix": "log",
"scope": "javascript,typescript,typescriptreact",
"body": ["console.log($1);", "$0"],
"description": "Insert console.log"
}
}
注意：scope 字段只在全局 snippets 文件中有效，在语言级 JSON（如 javascript.json）里写 "scope" 会被忽略。OpenCode VS Code 等定制版对 scope 的解析更严格，建议只列真实存在的 language ID，别加空格或多余字符。
真正麻烦的是变量正则替换和嵌套作用域判断，比如想根据文件名生成 PascalCase 组件名，不同 VS Code 版本对 ${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/} 的支持程度不一，试错成本高——这种逻辑建议先在简单场景验证，再逐步叠加。
