VS Code 自定义代码块需将 JSON 文件按语言 ID 命名并置于对应路径：用户级为 ~/.vscode/snippets/{language}.json，工作区级为 .vscode/snippets/{language}.json；prefix 触发补全，$1/$0 控制光标跳转，必须确保文件语言模式与 snippet 语言 ID 严格匹配。
VS Code 怎么添加自定义代码块（snippets）
直接在用户或工作区级别新建 snippets JSON 文件，VS Code 就能识别并自动补全。不是插件，不用重启，改完保存即生效——但必须确保语言标识符（language）和文件扩展名/打开的文件类型严格匹配。
snippet 文件放哪？怎么命名？
路径和命名决定作用范围与触发时机：
- 全局生效（所有该语言文件）：打开命令面板
Preferences: Configure User Snippets→ 选语言（如javascript），会自动创建javascript.json到~/.vscode/snippets/ - 仅当前项目生效：在工作区根目录建
.vscode/snippets/javascript.json（注意路径里有.vscode文件夹） - 文件名必须和语言 ID 一致（
typescript.json对应 TS 文件，不是ts.json；python.json有效，py.json无效）
一个可用的 snippet 结构长什么样
别套模板，直接抄这个最小可运行结构（以生成 React 函数组件为例）：
{
"React Functional Component": {
"prefix": "rfc",
"body": [
"const $1 = () => {",
" return (",
" <$2 />",
" );",
"};",
"",
"export default $1;"
],
"description": "Create a React functional component"
}
}
关键点：
-
prefix是你输入后按 Tab 触发的关键字（rfc→ 按 Tab → 展开） -
$1、$2是光标跳转位，按 Tab 可依次切换；$0是最终停留位 -
body是字符串数组，每行一项，换行靠数组元素分隔，不是\n - 如果想在 JS 文件里用，必须放在
javascript.json或typescript.json中，不能塞进json.json
为什么写了不生效？常见卡点
90% 的问题出在语言上下文不匹配：
- 当前文件是
App.tsx，但 snippet 放在javascript.json→ 不触发（得放typescript.json或javascriptreact.json） - 文件没设置语言模式（右下角显示 “Plain Text”）→ 点击它，选 “TypeScript React”
- JSON 格式错误（多逗号、少引号、中文标点）→ VS Code 不报错，但整个 snippet 文件失效
- 用了
scope字段但拼写错误（如"scope": "typescript"是错的，正确是"scope": "source.ts"，但一般不需要加）
最稳妥的做法：始终通过 Configure User Snippets 命令创建，避免手建路径或命名偏差。语言 ID 不确定时，打开对应文件 → Ctrl+Shift+P → 输入 “Change Language Mode” 看右下角显示的真实 ID。
