VSCode自定义代码片段需通过Preferences: Configure User Snippets命令打开对应JSON文件配置，而非手动创建；必须包含"prefix"、"body"（字符串数组）、"description"三字段，且语言模式需匹配。
VSCode 自定义代码片段不是靠“新建文件”实现的，而是通过编辑 snippets JSON 文件触发生效；改完不重启、不重载窗口，片段就不会被识别。
如何打开正确的代码片段配置文件
快捷键 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入并选择 Preferences: Configure User Snippets —— 别手动去 .vscode/snippets/ 下建文件，VSCode 不会自动扫描该目录下的任意 JSON。
选择后会出现语言列表，选 javascript 就生成 javascript.json，选 New Global Snippets file... 则创建全局可用的 global.code-snippets（注意后缀是 .code-snippets，不是 .json）。
- 项目级片段：选具体语言 → 生成语言专属文件，仅在该语言上下文中触发
- 全局片段：选
New Global Snippets file...→ 文件名随意，但必须以.code-snippets结尾 - 错误做法：直接在工作区建
.vscode/snippets/my.js—— VSCode 完全无视
片段结构里哪些字段不能少
一个能用的片段至少包含 "prefix"、"body"、"description" 三者。漏掉 "prefix" 就没法触发；"body" 是插入内容，必须是字符串数组（哪怕只有一行也要写成 ["console.log();"]）；"description" 虽然不报错，但没它就看不到提示文字，实际使用时根本不知道自己定义了啥。
常见错误示例："body": "console.log($1);"（字符串非数组）→ 片段加载失败，VSCode 控制台会报 Invalid snippet definition。
-
"prefix"：触发关键词，比如"log"，输入后按Tab插入 -
"body"：必须为字符串数组，换行用多个数组元素，如["function $1() {", " $0", "}"] -
"$1、$2、$0：占位符，$0是最终光标位置，$1是第一个跳转位
为什么写好了却没反应？检查这三点
片段写完保存，但输入 prefix 没提示，大概率卡在这几个环节：
- 当前文件语言模式和片段文件不匹配：比如在
.ts文件里写javascript.json片段，默认不生效（TypeScript 有自己的typescript.json） - JSON 格式错误：多逗号、少引号、注释未删（VSCode 的 snippets 不支持
//注释） - 片段被禁用：打开命令面板执行
Developer: Toggle Developer Tools，看 Console 是否有Failed to load snippets类报错
临时验证方法：在目标文件中按 Ctrl+Space 手动唤出建议列表，搜索你的 prefix，如果出现带「snippet」图标的条目，说明已加载成功。
最易忽略的是语言作用域——很多人把 React 相关片段写进 javascript.json，但在 .jsx 或 .tsx 文件里根本不出现在补全里，得分别配到 javascriptreact.json 和 typescriptreact.json 里才行。
