必须通过命令面板执行“Preferences: Configure User Snippets”创建代码片段文件，手动新建的.json或.code-snippets文件不会被VS Code加载；文件名与后缀决定作用域，body必须为字符串数组，语言ID需准确匹配右下角显示的语言模式。
必须用命令面板打开，不能手动建文件
VS Code 不会自动加载你手动在 snippets/ 目录下新建的 .json 或 .code-snippets 文件。哪怕路径完全正确、内容也合法，它就是不读——没报错，也不触发，纯静默失效。
唯一可靠的方式是通过内置命令生成：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板 - 输入
Preferences: Configure User Snippets并回车 - 从弹出菜单中选择：
•New Global Snippets file…（全局可用）
• 或直接选语言（如javascript），生成javascript.json（仅对该语言生效）
VS Code 会自动创建文件、写好基础结构、并打开编辑器——这一步不可跳过。
文件名和后缀决定作用域和加载方式
你选的名称和后缀，直接影响片段在哪生效、怎么被识别：
- 选
New Global Snippets file…后输入my-utils→ 生成my-utils.code-snippets，放在用户snippets/目录下，支持scope字段控制语言范围 - 选语言如
typescriptreact→ 生成typescriptreact.json，只在.tsx或.ts（且语言模式为 TypeScript React）文件中生效 - 误输成
ts.json或vue.js→ VS Code 根本不认，文件存在也没用 - 想跨语言？别用
.json全局文件，改用.code-snippets后缀，并显式写"scope": "javascript,typescript,vue"
语言 ID 必须准确，查法：按 Ctrl+Shift+P → 输入 Developer: Inspect Editor Tokens and Scopes → 看顶部显示的 languageId。
body 必须是字符串数组，不是字符串
这是最常导致“写了却没反应”的硬性规则。VS Code 对 body 字段极其敏感，错一点就整个片段静默丢弃：
- ✅ 正确：
"body": ["function $1() {", "\t$0", "}"]（每行一个字符串） - ❌ 错误：
"body": "function $1() {\n\t$0\n}"（单字符串 +\n） - ❌ 错误：
"body": ["function $1() {\n\t$0\n}"]（数组只有一项，含换行符） - 缩进必须显式写
"\t"，不能直接粘贴带空格/Tab 的代码行（会引入不可见控制符） -
$1、$2是制表位，$0是最终光标；两个$1（无大括号）会被忽略，不会联动跳转
改完不生效？先看右下角语言模式
片段是否触发，第一判断依据不是你输的前缀，而是当前编辑器右下角显示的语言模式（比如 JavaScript、TypeScript React、Plain Text）：
- 你在
index.tsx里敲logd，但片段写在javascript.json中 → 不触发（因为语言模式是typescriptreact，不是javascript） - 你在未保存的
Untitled-1里敲，右下角显示Plain Text→ 只有 scope 为空或明确包含plaintext的片段才可能出来 - 文件没保存 → 某些版本的 VS Code 不加载 snippets，先
Ctrl+S - 前缀太短（如
i）→ VS Code 默认至少输入 2 字符才展示 snippet 补全项
真正难调的不是语法，而是语言 ID 和上下文匹配——它不报错，只沉默，得靠右下角那个小标签反复验证。
