VSCode代码片段生效需同时满足三条件：文件路径与语言ID匹配、JSON结构合法、编辑器语言模式与片段作用域一致；否则prefix不会出现在补全列表。
VSCode 的代码片段不会“写完就生效”，必须满足三个硬性条件：文件路径和命名匹配语言 ID、JSON 结构合法、当前编辑器语言模式与片段作用域一致。漏掉任一环节，prefix 都不会出现在补全列表里。
怎么打开并编辑正确的 snippets 文件
别手动建 .vscode/snippets/ 目录或瞎改文件名。最稳的方式是用命令面板：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入并选择
Preferences: Configure User Snippets - 从列表中选目标语言（如
javascript→ 生成javascript.json；选New Global Snippets file→ 文件名必须以.code-snippets结尾，比如common.code-snippets）
手动创建时路径不能错：%APPDATA%\Code\User\snippets\（Windows）、$HOME/Library/Application Support/Code/User/snippets/（macOS），文件名必须和 VSCode 内部语言 ID 完全一致——typescriptreact.json 不是 tsx.json，python.json 不是 py.json。
片段 JSON 必须包含哪几个字段
一个能被识别的片段，顶层对象里每个子项都必须有且仅有这三个字段：
-
"prefix"：纯字符串，大小写敏感，不支持正则。比如设为"log"，就得敲log+Tab，敲Log就没反应 -
"body"：必须是字符串数组，哪怕只有一行也要写成["console.log($1);"]。写成"console.log($1);"（单个字符串）或["console.log($1);\n$0"]（带\n）都会静默失败 -
"description"：不是可选字段。没有它，你在补全列表里根本看不到这个片段的提示文字，等于白写
常见错误："body": ["function () {", " <p>常见错误：<code>"body": ["function $1() {", " $0", "}"] 中混用空格和制表符，复制粘贴后缩进错乱；或忘记转义双引号，导致 JSON 解析失败。
为什么输入 prefix 没反应？优先检查这三处
不是代码写得不够好，而是环境没对上：
- 当前文件右下角显示的语言模式和片段文件不匹配。在
.ts文件里试javascript.json的片段？默认不生效。TypeScript 要用typescript.json或显式加"scope": "typescript" - JSON 格式非法：顶层不是对象
{}、多了一个逗号、用了//注释、编码含 BOM（尤其 Windows 记事本另存时容易中招） - 片段被禁用或加载失败：打开开发者工具（
Developer: Toggle Developer Tools），看 Console 有没有Failed to load snippets类报错；或者按Ctrl+Space手动唤出建议列表，搜你的prefix，如果没带「snippet」图标，说明压根没加载
改完保存后无需重启，但切换语言标签页或执行 Developer: Reload Window 有时能绕过缓存问题。
光标跳转和变量怎么写才不崩
$1、$2、$0 不是变量，只是占位锚点，不会被求值。它们的作用是控制 Tab 键顺序：
-
"body": ["console.log('${1:msg}');", "$0"]：先填msg默认值，Tab 跳到末尾 -
"body": ["${1:const} ${2:name} = ${3:value};", "$0"]：三次 Tab 分别停在声明方式、变量名、值的位置 - 同一数字重复出现会同步编辑：
"body": ["function $1() {}", "const $1 = () => {};"]，改一处，两处一起变 - 内置变量如
$TM_FILENAME_BASE、$CURRENT_YEAR必须用${}包裹，写成$TM_FILENAME_BASE（无大括号）无效
最容易忽略的是：片段不支持任何动态逻辑，所有内容都是静态展开。想根据上下文自动补全函数签名？那得靠 Language Server，不是 snippet 的活。
