vscode代码片段需严格匹配语言id、json结构合法、重载窗口才生效；语言id必须与右下角显示完全一致，body须为字符串数组，$0不可缺失，修改后须执行developer: reload window。
VSCode 代码片段不是“装了就快”，而是必须配对语言模式、写对 JSON 结构、避开变量嵌套陷阱，才能真正减少重复输入。配错一个字母或漏掉一个逗号，prefix 就不会出现在 IntelliSense 里。
为什么输入了前缀却没提示？语言 ID 不匹配是最常见原因
VSCode 不是按文件扩展名（如 .ts）找片段，而是按右下角显示的「语言模式」（Language Mode）加载对应文件。比如一个 index.tsx 文件，右下角若显示 TypeScript React，它只会读取 typescriptreact.json；如果显示的是 TypeScript，则只认 typescript.json。
- 用
Ctrl+Shift+P→ 输入Change Language Mode确认当前语言 ID，大小写必须完全一致 - 片段文件名必须和语言 ID 完全相同，不能写成
tsx.json或react.json - 全局片段（
snippets.code-snippets）只在editor.suggest.showSnippets为true时生效 - 项目级片段优先级高于全局，路径必须是
.vscode/snippets/typescriptreact.json，不是.vscode/typescriptreact.json
body 中的占位符怎么写才不翻车？别嵌套、编号要递进、空格要手动
VSCode 片段的 body 是字符串数组，每行一条。光标跳转靠 、，默认值靠 ${1:default}，但有硬性限制：
-
$0是最终停留位置，不是编号终点；$1必须存在，$2才能生效，不能跳号 - 禁止嵌套占位符，例如
${1:${2:value}}会直接失效，VSCode 不解析 - 缩进必须用空格（非 Tab），否则插入后格式错乱；多行结构建议用数组逐行写，别拼成单个长字符串
- 跨位置同步修改用
${1:name}，但所有同名编号必须在同一片段内，不能跨片段复用
如何让 rfc 插入后光标自动停在组件名？React 模板的实操要点
一个可用的 React 函数组件片段，核心是把命名、props 类型、返回值三处都设为可编辑点，并保证语言上下文不越界：
{
"React FC template": {
"prefix": "rfc",
"body": [
"const ${1:name} = ({",
"\t${2:props}",
"}: ${3:Props}) => {",
"\treturn <div>${4:content}</div>;",
"};",
"",
"export default ${1:name};"
],
"description": "Create a React functional component with props and export"
}
}
-
${1:name}同时出现在函数名和export default行，Tab 切换时两处同步更新 - 第二行
${2:props}是 props 占位，避免手输时漏掉解构括号 - 第三行
${3:Props}是类型占位，留空或填any都可，比写死Props更灵活 - 最后一行空行保留，避免插入后紧贴上一行影响可读性
团队共享片段怎么避免冲突和维护混乱？
项目级片段放 .vscode/snippets/ 下是唯一稳妥方式，但要注意三个实际约束：
- 文件必须是合法 JSON，外层是对象，不能以数组开头；VSCode 不报错，但整个文件不加载
- 每个片段的键名（如
"React FC template"）仅用于内部识别，不影响触发，可写中文或带空格 - 不要把所有语言片段塞进一个文件，按语言 ID 拆分（
javascript.json、typescriptreact.json），否则容易误触发 - Git 提交时确保
.vscode/snippets/在.gitignore外，但排除.vscode/settings.json等用户私有配置
最常被忽略的一点：修改片段后必须重载窗口（Ctrl+Shift+P → Developer: Reload Window），热更新不生效。
