VS Code用户级Snippets文件须置于指定路径并命名规范：macOS/Linux为~/.vscode/snippets/，Windows为%USERPROFILE%\AppData\Roaming\Code\User\snippets\，文件名必须为{language-id}.json（如javascript.json），JSON格式需严格合法，且需通过Developer: Inspect Editor Tokens and Scopes确认语言ID，否则补全不触发。
Snippets 文件该放在哪，路径写错就全白搭
VS Code 的用户级 Snippets 文件必须放在 ~/.vscode/snippets/（macOS/Linux）或 %USERPROFILE%\AppData\Roaming\Code\User\snippets\（Windows）下，且文件名需带语言后缀，比如 javascript.json 或 python.json。放错位置（例如丢进工作区的 .vscode/ 但没配 "scope": "user"）会导致代码补全完全不触发。
常见错误现象：console.log 缩写 clg 输入后无反应、按 Tab 没展开、甚至整个 Snippets 列表里搜不到自定义项。
- 确认语言 ID 正确：用
Ctrl+Shift+P→Developer: Inspect Editor Tokens and Scopes查当前文件真实 language ID（比如 TypeScript 文件可能是typescript，不是ts） - 文件名必须是
{language-id}.json，不能是my-snippets.json或js.json - JSON 格式必须合法：缺逗号、多逗号、末尾多逗号、单引号都会让整个文件失效（VS Code 不报错，只是静默忽略）
定义一个能跳转光标的 snippet，不是简单替换
真正好用的 Snippet 要支持 Tab 键顺序跳转占位符，而不是一次性把所有内容贴死。核心靠 $1、$2 这类 tabstop 编号，以及 ${1:default} 提供默认值。
比如写 React 函数组件，希望输入 rfc 后展开为：
const ${1:ComponentName} = () => {
return <div>${2:content}</div>;
};
export default ${1:ComponentName};
这样按一次 Tab 光标跳到组件名位置，再按一次跳到 content 位置 —— 不用鼠标、不手动删占位符。
-
$1和$2是顺序跳转点；重复编号（如两个$1）表示同步更新 -
${1:MyComp}表示光标首次停在此处时，已预填MyComp，可直接回车跳过 - 别用
$0做终点以外的用途：它代表最终光标停留位，设多了会打断跳转逻辑 - 换行和缩进必须用真实空格或
\t，VS Code 不自动对齐；建议在 JSON 的body数组里每行写一行字符串，方便控制
如何让 snippet 只在特定文件类型生效，又不污染全局
Snippet 默认作用域是「当前语言」，但有时需要更细粒度控制：比如只在 .tsx 文件生效、或排除 node_modules 下的文件。这时得靠 scope 字段和 VS Code 的文件关联机制。
关键不在 Snippet 本身加 scope，而在于文件后缀是否被正确映射到 language ID。例如你写了 typescriptreact.json，但打开的文件右下角显示的是 typescript，那这个 Snippet 就不会触发。
- 检查右下角语言模式，点击它 → “Configure Language Specific Settings” → 确保
.tsx关联到typescriptreact - 如果想跨语言复用（比如 JS 和 TS 都要
clg），就分别建javascript.json和typescript.json，内容一致即可 - 不想让 snippet 在 Markdown 代码块里误触发？VS Code 没法按“嵌入语言”过滤，只能靠命名规避（比如不用
log而用js-log）
调试 snippet 不生效：看输出面板比猜强十倍
VS Code 自带 Snippet 调试入口，比翻文档快得多。打开命令面板 Ctrl+Shift+P，输入并执行 Developer: Toggle Developer Tools，切到 Console 标签页，然后在编辑器里输入你的 prefix（如 clg），看控制台有没有报错或警告。
更直接的方式：用 Ctrl+Space 手动唤出补全列表，输入 prefix，观察是否出现你的 snippet 条目。不出现？八成是路径、文件名、language ID 三者之一错了。
- 启用
"editor.quickSuggestions": {"other": true}，确保普通文本也触发补全（否则 .md 或未识别后缀里看不到） - 临时禁用其他 Snippet 插件（比如 Auto Close Tag、ES7 React Extensions），它们可能劫持同名 prefix
- 修改完 JSON 后不用重启 VS Code，但必须重新打开一个对应语言的文件才能加载新规则
