VSCode 的 settings.json 用户配置文件不在安装目录，而位于系统级配置目录：Windows 为 %APPDATA%\Code\User\settings.json，macOS 为 ~/Library/Application Support/Code/User/settings.json，Linux 为 ~/.config/Code/User/settings.json。
导出 settings.json 文件的正确路径在哪里
VSCode 的用户配置文件 settings.json 不在安装目录里，而是在系统级配置目录下，直接找错位置会导致导出空文件或覆盖失败。
Windows：打开文件资源管理器，粘贴路径 %APPDATA%\Code\User\settings.json
macOS：终端执行 code --locate-user-data，然后进 Library/Application Support/Code/User/settings.json
Linux：~/.config/Code/User/settings.json
- 别用 VSCode 界面里的「设置」→「打开设置 (JSON)」后手动复制内容——容易漏掉注释、格式错乱，且不包含已禁用的默认项
- 如果启用了 Settings Sync（登录 GitHub 账户），
settings.json会被自动忽略，此时导出的是“本地覆盖层”，不是全量配置 - 导出前建议先运行
code --list-extensions --show-versions > extensions.txt单独保存扩展列表
导入时 settings.json 被重写或不生效的常见原因
直接把旧 settings.json 拷贝进去不等于生效——VSCode 启动时会校验 JSON 格式，并合并部分设置（比如 "editor.fontSize" 冲突时以新值为准，但 "files.exclude" 是深合并）。
- 确保目标机器上 VSCode 已完全退出（任务管理器里确认没有
Code Helper进程残留） - 导入前删掉原
settings.json，不要用编辑器直接覆盖——某些编辑器会加 BOM 或换行符，导致 VSCode 解析失败并静默回退到默认值 - 检查是否有插件自动生成配置（如 Prettier、ESLint），它们可能在首次启动时重写
settings.json中相关字段 - 如果用了 Remote-SSH 或 WSL，
settings.json分为「User」和「Remote」两层，远程环境需单独同步~/.vscode-server/data/Machine/settings.json
用 Settings Sync 替代手动导出导入是否可靠
Settings Sync（GitHub 登录同步）能自动同步 settings.json、快捷键、代码片段、已安装扩展，但它不传本地路径类配置（如 "python.defaultInterpreterPath"）、不支持条件逻辑、且无法离线使用。
- 同步开启后，本地
settings.json会被标记为只读，所有修改必须通过 UI 设置面板或命令面板（Ctrl+Shift+P→Preferences: Open Settings (JSON)）触发同步写入 - 不同平台路径差异会导致同步失败，例如 Windows 的
"terminal.integrated.profiles.windows"在 macOS 上被忽略，但不会报错 - 企业网络若屏蔽 GitHub API（
https://api.github.com），同步会卡在「Syncing…」状态，日志里提示Failed to fetch user data
真正跨设备一致的最小可行同步方案
纯手工同步太脆弱，全靠 Settings Sync 又受限太多。折中做法是：用 Git 管理 settings.json + 扩展列表 + 关键插件配置文件（如 .prettierrc），再配一个启动脚本自动拉取和软链接。
- 把
settings.json和keybindings.json放进私有仓库，用git clone到每台机器的~/.dotfiles/vscode/ - 写个
setup-vscode.sh，用ln -sf ~/.dotfiles/vscode/settings.json "$HOME/Library/Application Support/Code/User/settings.json"建软链（Windows 用mklink） - 扩展用
code --install-extension ms-python.python --force批量重装，--force避免跳过已存在版本 - 注意：插件自身存储的状态（如 GitLens 的历史缓存、TODO Tree 的索引）不会同步，这部分只能接受设备间差异
最麻烦的从来不是配置本身，而是那些没写进 settings.json 却影响行为的隐式状态：窗口布局、调试断点、最近打开的文件夹记录——这些没法同步，每次换机器都得手动重置一次。
