VSCode自定义代码片段不能直接共享库式安装，必须手动同步snippets文件夹或通过扩展分发；新增需编辑JSON文件，注意命名、编码、格式及转义规则。
VSCode 的自定义代码片段不能直接“共享库”式安装，必须手动同步 snippets 文件夹或通过扩展分发——这是最常被误解的起点。
如何在本地添加自定义代码片段（JSON 格式）
VSCode 的代码片段以 JSON 文件形式存放在用户或工作区的 snippets 目录下。新增片段不靠 UI 点击，而是编辑文件：
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Preferences: Configure User Snippets - 选择
New Global Snippets file...，输入文件名如react-hooks.code-snippets - VSCode 会自动在
~/.vscode/snippets/（macOS/Linux）或%USERPROFILE%\AppData\Roaming\Code\User\snippets\（Windows）创建该文件 - 按官方格式编写：每个片段是键值对，键为触发前缀（如
useFetch），值包含prefix、body、description等字段
注意：body 中的换行必须写成 "\\n"（JSON 字符串内需双反斜杠），光标位置用 $1、$2 表示，而非 ${1} 这类 VS Code 扩展语法——后者只在扩展中生效。
为什么不能直接把 .code-snippets 文件发给同事用
因为 VSCode 不会自动加载任意路径下的 JSON 片段文件。即使同事把你的 my-team.code-snippets 放进自己 snippets 目录，也需满足两个条件才生效：
- 文件名必须以
.code-snippets结尾（不能是.json） - 文件顶层必须是对象（
{}），不能是数组（[]）或带 BOM 的 UTF-8 编码（Windows 记事本易加 BOM，导致加载失败） - 若片段作用于特定语言（如 TypeScript），需在文件名中体现语言标识，例如
typescript.json是合法语言级片段；而my-ts.code-snippets是全局片段，不会自动绑定到typescript语言模式
常见报错现象：Failed to load snippets from ...: Unexpected token，大概率是编码或 JSON 格式问题。
团队共享的可行方案：Git + 预设脚本 or 封装为 Extension
纯文件同步容易出错且无版本提示，推荐两种落地方式：
-
Git + 初始化脚本：将所有
*.code-snippets文件放入项目根目录.vscode/snippets/，再提供一个setup-snippets.sh（或setup-snippets.ps1），内容为软链接命令（macOS/Linux）或 mklink（Windows），把项目内片段链接到用户snippets目录 -
打包为 VS Code 扩展：用
yo code创建 Extension 工程，把片段放snippets/子目录，声明在package.json的contributes.snippets字段中，指定language和path。发布后团队统一安装扩展，更新由 VS Code 自动管理
扩展方式更健壮，但要求团队接受「额外安装一个内部扩展」；脚本方式轻量，但 Windows 用户常卡在权限和符号链接上——这是最容易被跳过的兼容性细节。
真正麻烦的不是写片段，而是确保 prefix 不冲突、body 中的转义正确、以及每次新增都同步到所有人的环境。别信“复制粘贴就能用”。
