最可靠方式是手动导出settings.json、keybindings.json、snippets/目录和code --list-extensions列表;Settings Sync因路径错乱、禁用插件丢失、代码片段不同步等问题,不适合环境迁移。

最方便的导出方式取决于你是否联网、是否多设备长期使用,以及是否需要可审计、可回滚的备份——Settings Sync 适合日常同步,但重装系统或跨平台迁移时,手动导出 settings.json、keybindings.json、snippets/ 和 extensions.txt 才真正可靠。
用 code --list-extensions 导出扩展列表,别截图或手抄
扩展 ID 是大小写敏感的字符串(如 ms-python.pylance),手输极易出错;截图无法用于脚本恢复。命令行导出是唯一能直接对接安装命令的方式。
- 基础导出:
code --list-extensions > extensions.txt - 带版本号(便于团队对齐):
code --list-extensions --show-versions > extensions.txt - 若提示
command not found: code,先在 VSCode 中按Ctrl+Shift+P运行Shell Command: Install 'code' command in PATH - 注意:禁用的扩展不会出现在该列表中,这是预期行为;真要记录全部,得进
~/.vscode/extensions/手动ls,但重装时基本不需要
别只导 settings.json,keybindings.json 和 snippets/ 必须一起拿
只导 settings.json 是最常见遗漏点。你改过的 Ctrl+Shift+P 行为、自定义 Emmet 快捷键、JavaScript 片段都存在另外两个地方,漏掉就等于重头配置。
-
keybindings.json默认为空,只有你改过快捷键才会生成;它不随 Settings Sync 全量同步(尤其跨平台时ctrl/cmd映射可能失效) -
snippets/是一个目录,不是单个文件;比如javascript.code-snippets和python.code-snippets都在里面,必须整个拷出 - 路径位置(务必确认):
Windows:%APPDATA%\Code\User\
macOS:$HOME/Library/Application Support/Code/User/
Linux:$HOME/.config/Code/User/
覆盖配置后不生效?检查这三件事
文件放对了 ≠ 配置立刻生效。VSCode 启动时会校验、合并、甚至静默忽略某些内容,很多“没反应”其实卡在启动前。
- 确保 VSCode 完全退出:Windows 检查任务管理器里有没有残留的
Code Helper进程;macOS/Linux 用ps aux | grep code - 不要用编辑器直接覆盖
settings.json:某些编辑器会加 BOM 或换行符,导致解析失败并回退到默认值;建议删旧文件再粘贴新内容 - 检查是否有插件自动生成配置:比如 Prettier、ESLint、Python 插件首次启动时会往
settings.json写字段,可能覆盖你的手动设置
Settings Sync 不是万能的,这些坑它填不了
Settings Sync 看似一键搞定,但它不处理路径依赖、不兼容平台差异、不同步本地状态,且失败时难排查。
-
python.defaultInterpreterPath、terminal.integrated.env.linux这类含绝对路径或平台限定的设置,同步到另一台机器上会失效甚至报错 - Remote-SSH / WSL 环境的配置存在
~/.vscode-server/data/Machine/settings.json,Settings Sync 不管这一层 - UI 布局(如侧边栏展开项、活动编辑器标签页顺序)属于“状态”,不是“配置”,同步后常丢失
- 启用同步后,
"sync.enable": true会令本地settings.json变为只读,所有修改必须走 UI 或命令面板,否则被忽略
真正麻烦的不是导出动作本身,而是导出内容是否完整、路径是否适配、扩展是否真能装上——尤其是跨平台或 VS Code 大版本升级后,ms-python.python 拆成 ms-python.pylance 和 ms-python.python 这种变化,靠旧列表根本恢复不了。











