VSCode设置同步需确保GitHub/Microsoft账户登录成功、同步范围正确、版本一致且GitHub token含gist权限，否则会出现配置不更新、扩展兼容性错误或静默失败。
同步开关已开但设置没更新
VSCode 的 Settings Sync 功能依赖 GitHub 或 Microsoft 账户登录状态，不是开了开关就自动生效。常见现象是：在设备 A 上改了 editor.fontSize，设备 B 点击 Sync: Show Synced Data 却看不到该配置，或者同步状态一直显示 Syncing... 卡住。
- 先确认账户已成功登录：打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Settings Sync: Turn On，如果提示“Already signed in”，说明已登录；否则需手动触发登录流程 - 检查同步范围是否被限制：默认只同步
settings.json、键盘快捷键、扩展、UI 状态等，**不包括工作区设置（.vscode/settings.json）或用户自定义片段（snippets/目录）** - 同步延迟真实存在：首次开启或大变更后，可能需要 1–3 分钟才完成全量同步，期间不要反复点击
Sync Now
扩展同步失败或版本不一致
扩展列表能同步，但安装/启用状态、扩展配置（如 prettier.configPath）未必同步成功。更常见的是：设备 A 同步了扩展 v2.5.0，设备 B 却卡在 v2.4.1，甚至出现 Extension 'esbenp.prettier-vscode' is not compatible with Code v1.85.0 这类错误。
Miller CSV TSV JSON 数据处理器
下载
Miller (mlr) 是一个命令行工具，用于查询、整形和重新格式化名称索引数据，如 CSV、TSV、JSON 和 JSON Lines。它将 awk、sed、cut、join 和 sort 的功能整合到一个专为结构化数据处理而构建的单一工具中。
- 确保两台设备 VSCode 版本一致：运行
Help > About查看版本号，不同主版本（如 1.84 vs 1.85）可能导致扩展兼容性中断，同步会跳过不兼容项 - 扩展配置需显式写入用户设置：例如 Prettier 路径必须放在
settings.json里，而不是仅在扩展 UI 中设置 —— 后者不会被同步 - 禁用「自动更新扩展」可能干扰同步：建议保持
extensions.autoUpdate为true，否则旧版本扩展可能阻塞新配置加载
同步冲突：本地修改被覆盖或丢失
当多设备同时修改同一配置（比如都改了 files.exclude），VSCode 不做合并，而是以「最后同步时间戳」为准覆盖。你可能发现刚加的 "**/dist": true 下次打开就没了。
- 同步冲突没有交互式提示，只有日志可查：打开命令面板 →
Developer: Toggle Developer Tools→ Console 标签页，搜索conflict或overwrite - 恢复误覆盖配置的最快方式：在任一设备上打开
Command Palette→Settings Sync: Show Synced Data→ 点击对应配置项右侧的Revert按钮 - 敏感配置建议绕过同步：例如含本地路径的
python.defaultInterpreterPath、公司代理设置等，可在settings.json中用// @sync false注释标记（VSCode 1.86+ 支持）
GitHub Token 权限不足导致同步静默失败
用 GitHub 账户登录时，VSCode 会申请 user:email 和 read:user 权限。但如果之前授权过旧版应用，或手动删过 token，可能出现「看起来正常登录，实际无法写入同步数据」的情况 —— 表现为同步按钮始终灰色、无报错、也无日志。
- 手动检查 token 状态：访问 https://www.php.cn/link/f4380fd29ac34f2610014e8361d088fb，查找名为
VS Code Sync的 token，确认其权限勾选了gist（这是 Settings Sync 实际使用的权限） - 强制刷新授权：命令面板 →
Settings Sync: Turn Off→ 退出 VSCode → 删除~/.config/Code/User/globalStorage/state.vscdb（Linux/macOS）或%APPDATA%\Code\User\globalStorage\state.vscdb（Windows）→ 重启 VSCode 并重新开启同步 - Microsoft 账户用户注意：若组织策略禁用了第三方应用访问，需联系管理员开启
Allow third-party application access via OAuth
// 示例：正确写法（会被同步）
{
"editor.fontSize": 14,
"prettier.configPath": "./.prettierrc",
"files.exclude": {
"**/node_modules": true,
"**/dist": true
}
}
// 示例：不会被同步的配置（工作区级）
{
"python.defaultInterpreterPath": "/Users/me/project/venv/bin/python"
}
同步机制本身不复杂，但它的静默行为和权限边界容易让人误以为“功能坏了”。真正卡点往往不在 VSCode 设置里，而在 GitHub token 权限、扩展版本锁、或跨设备 VSCode 主版本差异上。 
