VSCode的Settings Sync默认不上传snippets/目录中的实际JSON文件，仅同步用户片段元信息；需手动勾选Snippets选项、确保文件路径正确（如macOS为~/Library/Application Support/Code/User/snippets/）、退出VSCode后完整备份该目录，或用Git管理并注意语言ID命名准确与编码权限问题。
snippets 文件夹为什么不能靠 Settings Sync 自动同步？
VSCode 的 Settings Sync 默认不上传 snippets/ 目录里的内容——它只同步「用户片段」的元信息（比如语言关联），但不会把 javascript.code-snippets 这类实际 JSON 文件传到云端。这是设计使然，不是 bug。如果你在新设备上登录后发现自定义代码片段全没了，大概率就是这个原因。
常见错误现象：
• 左下角显示 Synced，但打开 Preferences: Configure User Snippets 后空空如也
• GitHub 账户已登录、Snippets 选项已勾选，仍无效果
- 确认是否真的勾选了「Snippets」项（不是「User Snippets」这种模糊表述）——1.84+ 版本面板里明确写的是
Snippets - 检查 snippets 文件是否放在正确路径：
~/Library/Application Support/Code/User/snippets/（macOS）、%APPDATA%\Code\User\snippets\（Windows） - 如果 snippets 是通过扩展（如
vscode-custom-css）动态生成的，这类内容根本不会被任何同步机制捕获
手动备份 snippets 目录最稳妥的路径和时机
直接复制整个 snippets/ 文件夹是目前唯一 100% 可靠的方式。它体积小、纯文本、无平台依赖，且不受 VSCode 版本升级影响。
关键点：
- 必须在 VSCode 完全退出后操作，否则可能拷贝到未刷新的缓存版本
- 路径要精准：
snippets/是User/目录的子目录，不是extensions/或globalStorage/里的同名文件夹 - 不要只备份单个
.code-snippets文件——比如你有typescript.json和typescript.code-snippets两个文件，后者才是 VSCode 实际读取的
示例命令（macOS/Linux）：cp -r ~/Library/Application\ Support/Code/User/snippets/ ~/backup/vscode-snippets/
用 Git 管理 snippets 的实际约束
把 snippets/ 目录纳入 Git 仓库，确实能实现版本回溯和多端拉取，但要注意三处硬限制：
- Git 不会自动帮你解决冲突：两个终端同时改了同一个
python.code-snippets，合并时得手动处理 JSON 字段层级 - 文件名中的语言 ID 必须准确，比如
markdown.code-snippets不能写成md.code-snippets，否则 VSCode 不识别 - 某些 snippet 使用了变量（如
$1、${TM_FILENAME_BASE}），这些语法在不同 VSCode 版本中兼容性不稳定，1.79 之前版本对${fileBasenameNoExtension}支持不全
建议做法：
• 在 Git 仓库根目录加一个 README.md，记录每个 snippet 的用途和最后验证版本
• 避免在 snippet body 中嵌入绝对路径或用户名（如 /home/xxx/project）
跨终端还原 snippets 时最容易忽略的权限和编码问题
把备份好的 snippets/ 复制到新机器后，有时片段列表里能看到名字，但插入时没反应——问题往往不在逻辑，而在底层读取失败。
- Linux/macOS 下，确保文件权限为
644（chmod 644 *.code-snippets），否则 VSCode 可能静默跳过加载 - Windows 上用记事本编辑过 snippet 文件，容易混入 BOM（UTF-8 with BOM），导致 VSCode 解析失败；用 VSCode 自己打开并另存为 UTF-8（无 BOM）可修复
- 文件名含中文或空格时，部分旧版 VSCode（≤1.60）会拒绝加载，建议统一用英文+下划线命名，如
react_component.code-snippets
验证是否生效：重启 VSCode 后，在任意 .js 文件中输入 snippet prefix，看是否触发补全——别只看设置界面里有没有列出。
