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）。