VSCode中生成合法代码片段需手动创建.snippets文件并校验：prefix为字符串，body为字符串数组，description为纯文本；须按语言ID（如javascript）命名文件或设scope；编号需连续，修改后需重载窗口。
VSCode里怎么生成合法的代码片段JSON结构
直接写 snippets JSON 容易格式错、引号漏、逗号多，VSCode 自带的 snippet generator 并不存在——这是个常见误解。真正能用的是手动创建 + 校验，或靠扩展辅助生成骨架。
推荐做法：新建一个 .code-snippets 文件，用 VSCode 自动补全 + 语法高亮来降低出错率。VSCode 对 package.json 和 *.code-snippets 文件有专用 Schema 校验，只要字段名拼对、缩进规范，保存时就会提示错误。
-
prefix必须是字符串（不能是数组），用于触发补全，比如"log" -
body必须是字符串数组，每行一条语句，换行靠"\n"或拆成多元素，如["console.log($1);", "$2"] -
description是纯字符串，不支持换行或 Markdown，别写长段说明 - 变量占位符如
$1、$2、${1:default}只在body中生效，不能出现在description或prefix里
为什么你写的 snippet 在 JavaScript 文件里不生效
VSCode 的代码片段是按语言作用域绑定的，不是全局生效。即使你把 JSON 放在用户 snippets 目录下，没指定 "scope" 或语言标识，它默认只对 plaintext 生效。
常见错误：复制别人 Python 的 snippet 到自己的 javascript.json 里，但忘了改文件名或 scope；或者在 javascript.json 里写了 "scope": "typescript"——这不会生效，因为 scope 值必须和语言 ID 一致，JS 文件的语言 ID 是 javascript，不是 js 或 ts。
- 查当前文件真实语言 ID：按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac），输Change Language Mode，顶部会显示当前 ID - scope 字段可省略，但仅限于放在对应语言名的
.json文件中（如javascript.json） - 如果想跨语言复用（比如通用注释模板），只能放
global.code-snippets并配"scope": "javascript,typescript,html"，但注意：VSCode 不支持通配符，也不识别web这类分组别名
如何避免 $1 $2 占位跳转顺序错乱
VSCode 按数字顺序跳转，但如果你写了 后面又写 ，它仍会先停在 ——不是按书写顺序，而是按数字升序。更麻烦的是，如果漏掉某个编号（比如只有 和 ）， 不会变成第二个停靠点，而是直接跳过，导致编辑体验断裂。
真正可控的做法是用带默认值的格式 ${1:label}，并确保编号连续。VSCode 不校验是否连续，但跳转逻辑依赖它。
- 别手写
$0来当结束位：它只是“最终光标位置”，不会参与 Tab 跳转，且不能和$1等混用在同一个body行里（会冲突） - 多行 body 中，同一行出现多个变量（如
"const ${1:name} = ${2:value};"）是允许的，Tab 会依次停在name→value - 如果需要“选中后替换”，用
${1|a,b,c|}下拉选择，但注意：只支持英文逗号分隔，不支持空格或引号
Snippet JSON 文件路径和重载时机
VSCode 不会实时监听 snippets 文件改动。改完 javascript.json 后，必须重启窗口或手动触发重载，否则新片段不出现。
路径分两类：用户级（全局可用）和工作区级（仅当前文件夹）。用户级路径在设置页点「Open Settings (JSON)」旁的「Open User Snippets」就能跳转；工作区级要手动建 .vscode/snippets/ 目录，再放 javascript.code-snippets 这类文件（注意后缀是 .code-snippets，不是 .json）。
- 用户级文件名必须是语言 ID +
.json（如javascript.json），不能叫js.json - 工作区级文件名可以自定义，但必须放
.vscode/snippets/下，且后缀为.code-snippets - 改完后按
Ctrl+Shift+P输入Developer: Reload Window最快见效，别等自动同步 - 如果片段突然失效，先检查有没有同名 prefix 冲突（比如两个
log片段，后加载的会覆盖前一个）
最常被忽略的其实是 scope 和文件后缀的匹配关系：写对 JSON 结构只是第一步，语言 ID 错一位、文件放错目录、甚至多了一个空格，都会让整个 snippet 静默失败。调试时优先看状态栏右下角的语言标识，再核对 snippets 文件名和路径，比反复改 body 更有效。
