VSCode代码片段分全局和项目级：全局存于用户配置，适用于跨项目通用模板；项目级存于.vscode/目录，仅当前工作区生效且优先级更高。
VSCode 的代码片段（Snippets）支持全局（用户级）和项目级两种作用域，配置方式略有不同，但都基于 JSON 格式。关键在于文件存放位置和触发方式是否生效。
全局代码片段（所有项目通用）
全局片段对所有工作区生效，适合常用、语言无关或跨项目高频的代码块（比如 console.log 快捷写法、React 函数组件模板等）。
操作步骤：
- 打开命令面板（Ctrl+Shift+P 或 Cmd+Shift+P），输入并选择 Preferences: Configure User Snippets
- 选择一种语言（如 JavaScript）会创建对应语言的全局片段文件（如
javascript.json）；选 New Global Snippets file... 可创建一个不绑定特定语言的通用文件（如my-common.code-snippets） - 在打开的 JSON 文件中按格式编写片段，例如：
{
"log": {
"prefix": "log",
"body": ["console.log('$1');", "$2"],
"description": "Log to console"
}
}
保存后，在任意 JavaScript 文件中输入 log + Tab 即可展开。
项目级代码片段（仅当前工作区生效）
项目级片段只在当前 VSCode 工作区（即打开的文件夹）中生效，适合团队约定、框架定制或项目特有逻辑（如特定 API 调用模板、内部 Hooks 封装）。
操作步骤：
- 确保你的项目根目录下有
.vscode/文件夹（没有就手动创建） - 在
.vscode/下新建文件，命名为snippets.json（任意合法名均可，但必须是.json后缀） - 该文件内容结构与全局片段一致，但需显式指定语言作用域（通过
"scope"字段或文件名关联）——更推荐直接按语言建独立文件，例如：.vscode/typescript.json、.vscode/python.json - VSCode 会自动识别
.vscode/*.json中符合片段语法的文件，并在对应语言文件中启用
注意：项目级片段优先级高于全局片段，同名前缀会以项目级为准。
验证和调试技巧
片段不生效？常见原因和检查点：
- JSON 格式错误（多逗号、少引号、括号不匹配）→ 保存时 VSCode 通常会报错提示
- 语言标识不匹配：确认当前编辑器右下角显示的语言模式（如 “TypeScript React” 不等于 “TypeScript”，需单独配
typescriptreact.json） - 片段前缀含非法字符（只支持字母、数字、下划线、短横线），且不能是已存在的关键字（如
if在 JS 中可能被语言内置补全拦截） - 重启编辑器非必需，但修改
.vscode/snippets.json后建议保存并切到对应语言文件中测试
进阶建议：复用与维护
大型项目或团队可考虑：
- 把
.vscode/*.json片段文件纳入 Git，保证成员体验一致 - 用
"body"中的$1、$2定义跳转位，$0设为最终光标位置 - 结合变量如
${TM_FILENAME_BASE}（当前文件名不含后缀）动态生成内容 - 避免过度封装：片段应提升效率，而非增加记忆负担；简单逻辑直接写，复杂逻辑写函数
基本上就这些。配置一次，长期受益，不复杂但容易忽略细节。
