VSCode代码片段存放在三级路径：工作区级（.vscode/snippets/）、用户级（~/.vscode/snippets/或%USERPROFILE%\AppData\Roaming\Code\User\snippets\）、语言内置；优先级为工作区＞用户＞语言内置。
用户代码片段存放在哪里？路径和优先级怎么算
vscode 的代码片段分三级：全局（用户级）、工作区（项目级）、语言专属。优先级从高到低是：工作区 > 用户 > 语言内置。这意味着同名片段在项目里定义后，会覆盖用户级的同名片段。
路径如下：
- 用户级：
~/.vscode/snippets/（macOS/Linux）或%USERPROFILE%\AppData\Roaming\Code\User\snippets\（Windows） - 工作区级：
.vscode/snippets/（项目根目录下，需手动创建该文件夹）
注意：snippets 文件夹里不是放 JSON 文件，而是放 *.code-snippets 文件，比如 javascript.code-snippets 或 my-custom.code-snippets（后者是全局通用片段，不绑定语言）。
怎么写一个全局通用代码片段
全局通用片段不绑定具体语言，适用于所有文件类型，适合写工具函数、注释模板、日志占位符等。新建一个 my-common.code-snippets 文件，放在用户 snippets 目录下：
{
"log debug": {
"scope": "",
"prefix": "logd",
"body": [
"console.log('$1', $2);"
],
"description": "console.log with label and value"
},
"TODO comment": {
"scope": "",
"prefix": "todo",
"body": ["// TODO: $1"],
"description": "Insert TODO comment"
}
}
scope 留空表示全局生效；prefix 是触发关键词；$1、$2 是光标跳转位置，支持 Tab 切换。
常见坑：
- 文件名必须以
.code-snippets结尾，否则 VSCode 不识别 - JSON 格式必须严格合法（不能有末尾逗号、注释、单引号）
- 修改后无需重启，但要确保当前打开的文件类型没被其他更高优先级的同名片段覆盖
项目级片段怎么配？和用户级冲突怎么办
项目级片段用于团队统一规范（如特定 React 组件模板、API 请求封装），只在该工作区生效。在项目根目录建 .vscode/snippets/，再放 typescript.code-snippets：
{
"React FC template": {
"scope": "typescriptreact",
"prefix": "rfc",
"body": [
"const $1 = () => {",
" return (",
" $2",
" );",
"};",
"",
"export default $1;"
],
"description": "Create React functional component"
}
}
scope 值必须是 VSCode 认可的语言标识符（可用 Ctrl+Shift+P → Developer: Inspect Editor Tokens and Scopes 查看当前文件的 languageId）。
冲突处理逻辑：
- 如果用户级有
rfc，项目级也有同名rfc，且都作用于typescriptreact，则项目级生效 - 但如果项目级用的是
scope: "typescript"，而当前文件是.tsx，它实际 languageId 是typescriptreact，就不会触发——此时必须匹配准确 scope
如何快速编辑和调试片段
别手动找路径改 JSON。直接用命令面板：
-
Ctrl+Shift+P→ 输入Preferences: Configure User Snippets→ 选New Global Snippets file...或选某语言 - 已存在的片段文件会自动用 VSCode 打开，语法高亮 + 错误提示更友好
- 编辑时按
Ctrl+Space可唤出当前上下文可用的片段列表，验证是否生效
调试技巧：
- 在片段
body中加个明显字符（如"// SNIPPET TEST"），保存后立刻在目标文件中输prefix看是否出现 - 如果没反应，检查右下角语言模式是否正确（例如 .js 文件显示为 Plain Text 就不会加载
javascript.code-snippets） - 片段不支持嵌套变量（如
${1:${2:default}}），VSCode 不解析这种写法
最易忽略的一点：片段的 scope 字段不是“模糊匹配”，它必须和当前编辑器的 languageId 完全一致，哪怕只差一个字母（比如 ts ≠ typescript）。
