Snippets 不能靠 Settings Sync 自动同步，因首次同步时 VSCode 默认跳过目标设备已存在的同名文件（哪怕为空），且同步成功后不自动重载，需手动执行 Developer: Reload Window；同时 scope 字段拼写错误会导致静默失效。
Snippets 为什么不能靠 Settings Sync 自动同步？
Settings Sync 默认会同步 snippets，但实际中常“看起来开了，却没加载出来”。根本原因是：首次同步时 VSCode 默认跳过目标设备上已存在的同名 .json 文件（哪怕内容为空），且同步依赖 sync.enable 和 sync.include 中显式包含 snippets（虽然默认开启，但可能被手动关掉）。更隐蔽的问题是——snippets 同步不触发文件系统级重载，即使同步成功，VSCode 也不会自动扫描新片段，必须执行 Developer: Reload Window 或重启。
手动复制 snippets 目录最稳妥的实操步骤
直接复制整个 snippets/ 目录比依赖同步机制更可控，尤其当你只想迁移片段、不希望连带同步扩展或快捷键时。
- 先关闭所有 VSCode 实例（包括后台进程），否则文件可能被锁住或写入不完整
- 只复制
.json文件（如typescript.json、react.json），不要复制已弃用的.code-snippets格式文件 - 目标设备上若存在同名文件，建议先重命名备份（如
typescript.json.bak），再覆盖，避免因scope或prefix拼写错误导致整个文件失效 - 复制完成后，执行命令面板中的
Developer: Reload Window，而非仅刷新编辑器
团队共用 Snippets 时怎么避免 Git 冲突？
多人直接编辑同一个 javascript.json 是冲突高发区。按语言+职责拆分文件，配合精准作用域声明，才能让协作可持续。
- 每个子团队维护独立文件，例如
team-a-api.json、team-b-react.json，而不是挤在javascript.json里 - 在插件级共享时，用
package.json的contributes.snippets声明，务必指定"scope": "typescriptreact"这类精确值，避免意外劫持其他语言上下文 - Git 提交前运行
prettier --write *.json统一格式，减少无意义 diff；CI 中可加脚本校验必填字段（prefix、body）是否缺失
软链接方案在 macOS/Linux 和 Windows 上的差异
把项目内 .vscode/snippets/ 软链接到用户级目录，既能版本控制又能隔离修改，但跨平台实现方式不同。
- macOS/Linux：终端执行
ln -sf $(pwd)/.vscode/snippets ~/.config/Code/User/snippets（注意路径中Code可能是Code - Insiders） - Windows：需管理员权限运行
mklink /J "%APPDATA%\Code\User\snippets" ".vscode\snippets"，/J创建目录联结而非符号链接，兼容性更好 - 远程开发（SSH/WSL）时，软链接必须指向远端路径，不是本地；且 VSCode 必须重启才能识别变更
真正容易被忽略的是：Snippets 文件本身没有执行逻辑，但它对 scope 字段极其敏感——拼错一个字母（比如写成 "scop"），整个片段就静默失效，且 VSCode 不报任何错误。调试时优先检查该字段是否与语言 ID 完全一致（可通过 Developer: Inspect Editor Tokens 查看当前语言 ID）。
