VSCode代码片段默认不随Settings Sync自动同步，需同时满足：同步开关开启且Snippets项被勾选、目标设备为首次启用同步、使用本地窗口（非Remote-SSH/WSL）、snippets JSON无语法错误；离线插件安装须用code --install-extension命令配合绝对路径.vsix文件。
VSCode 离线下载插件和自动同步代码片段，其实是两件独立的事：插件离线安装靠的是 .vsix 文件 + 本地命令；而代码片段（snippets）**默认不随 Settings Sync 自动同步**，哪怕你开了“设置同步”，也常因配置遗漏或机制限制失效。
为什么 Settings Sync 常常不同步 snippets？
Settings Sync 默认会同步 snippets，但有三个关键前提必须同时满足：
- 同步开关已开启，且在同步选项中明确勾选了
Snippets（不是只勾了Settings或Extensions） - 目标设备是「首次启用同步」，否则 VSCode 默认跳过已存在的 snippets 文件——即使内容为空，也不会覆盖，需手动点右下角弹出的
Accept Incoming Changes - 你用的是本地窗口（非 Remote-SSH / WSL 等远程窗口），因为远程窗口默认不参与主账户的 Settings Sync，得单独登录并启用
更隐蔽的问题是：Settings Sync 实际上传的是加密后的 gist，而 snippets 的 JSON 结构一旦有语法错误（比如多逗号、少引号），VSCode 不报错，只是静默忽略该文件——你得手动打开 Preferences: Configure User Snippets 才能确认是否加载成功。
离线安装 .vsix 插件最稳的三步
别拖拽、别双击、别信图形界面提示。可靠路径只有这一条：
- 先确保
code命令可用：在 VSCode 中按Cmd+Shift+P（macOS）或Ctrl+Shift+P（Windows/Linux），输入Shell Command: Install 'code' command in PATH并执行 - 用绝对路径运行安装命令：
code --install-extension /path/to/extension.vsix（macOS/Linux）或code --install-extension "C:\full\path\to\extension.vsix"（Windows，含空格必须加引号） - 验证是否真生效：重启 VSCode 后，打开命令面板，输入插件名相关命令（如
Python: Select Interpreter），能调出即为成功；若失败，看输出面板（View → Output）里对应插件通道是否有spawn ENOENT或Failed to fetch
注意：.vsix 是自包含包，但像 ms-python.python 这类插件，首次启用时会联网下载 pyright 或 debugpy，离线环境必须提前在有网机器上触发一次完整加载，再把整个 ~/.vscode/extensions/ms-python.python-* 文件夹拷过去，而不是只拷 .vsix。
真正可靠的 snippets 同步：Git + 软链接
Settings Sync 不稳定，手动复制易覆盖，唯一可审计、可回滚、团队可协作的方式是 Git 管理 + 路径软链接：
- 把 snippets 目录挪到项目内：
mkdir -p .vscode/snippets && mv ~/Library/Application\ Support/Code/User/snippets/*.json .vscode/snippets/（macOS） - 建立软链接指向新位置：
rm -rf ~/Library/Application\ Support/Code/User/snippets && ln -sf $(pwd)/.vscode/snippets ~/Library/Application\ Support/Code/User/snippets - 提交到 Git：
git add .vscode/snippets && git commit -m "chore: add team snippets"，其他成员克隆后只需运行一遍软链接命令即可
这样做的好处是：JSON 格式统一可用 prettier --write *.json 格式化，避免 Git 冲突；新增 snippet 必须走 PR，不会被某人本地误删；还能配合 CI 脚本校验每个 .json 是否含必填字段 prefix 和 body。
复杂点在于：软链接路径必须是绝对路径，且 VSCode 重启后才识别；Git 提交前要确认所有 .json 文件都符合 VSCode 片段语法——少一个逗号，整份文件就失效，还不会报错。
