VS Code自定义代码片段需手动编辑JSON文件，通过命令面板打开对应语言片段文件，每个片段为含prefix、body、description的对象；body为字符串数组，支持$1、$2等光标跳转和${1:default}默认值；失效常见原因包括文件后缀不匹配、prefix含非法字符、scope与实际语言ID不符。
怎么创建自定义代码片段（JSON 格式）
VS Code 的代码片段本质是 JSON 文件，存放在特定路径下，不是通过图形界面点几下就能永久生效的。你得手动编辑 snippets 目录里的对应语言文件，或者用命令面板快速打开。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Configure User Snippets，回车 - 选语言（比如
javascript），会打开javascript.json；选New Global Snippets file则创建全局可用的.code-snippets文件 - 每个片段必须是对象，键名是触发名（如
log），值对象里至少包含prefix、body、description -
body是字符串数组，每行一个元素；换行和缩进会原样插入，所以注意空格对齐
为什么写完没反应？常见失效原因
最常遇到的是写了片段但输入 prefix 没提示，不是 VS Code 坏了，而是几个硬性条件没满足：
- 当前文件后缀名必须匹配片段所属语言（例如在
.ts文件里用javascript.json的片段——不行；得配typescript.json或用全局片段） -
prefix值不能含空格或特殊符号，只支持字母、数字、下划线、短横线 - 如果用了
scope字段（如"scope": "javascript,typescript"），必须确保当前语言 ID 确实是javascript（不是javascriptreact）——可以用Ctrl+Shift+P>Developer: Inspect Editor Tokens and Scopes查看真实语言 ID - 保存文件后无需重启，但修改后要等 1–2 秒 VS Code 重载配置（改完没立刻生效，先等一下）
如何让片段支持变量和光标跳转（$1、$2、${0:default}）
静态代码不够用时，要用占位符实现交互式插入。VS Code 支持标准的 TextMate 片段语法，但容易写错格式导致跳转失效：
-
$1、$2表示光标停靠位置，数字决定跳转顺序；$0是最终光标位置（通常放末尾） -
${1:label}表示带默认值的可编辑字段，比如"body": ["console.log('${1:message}');", "$2"] - 如果字段内容含
$、{、}，必须双写转义：$$、\{、\} - 别在
body里混用制表符和空格缩进——VS Code 会按第一个非空行的缩进基准对齐所有行，混乱缩进会导致插入后格式错乱
全局片段和项目级片段怎么选？
用户级片段（Configure User Snippets 创建的）全工作区生效，但没法随项目提交；项目级片段则需要在工作区根目录建 .vscode/snippets/ 并放 JSON 文件，再加 "editor.snippetSuggestions": "top" 到 .vscode/settings.json 才能启用。
- 团队协作优先用项目级：把
react.code-snippets提交到 Git，新人开箱即用 - 个人常用工具函数（如
debounce模板）放全局，避免每个项目重复配 - 注意：项目级片段只在该工作区根目录下打开的文件中生效；如果用多根工作区（multi-root workspace），需确保片段文件放在正确的子文件夹下
.vscode 目录是否已加入 Git；最麻烦的是语言 ID 和 scope 匹配——看着是 JS 文件，实际语言模式可能是 javascriptreact，这时候片段就得单独配一份。 
