必须先覆盖User文件夹再启动VSCode,因其首次启动会自动生成默认配置并覆盖旧设置;需完整备份settings.json、keybindings.json、snippets/和extensions.json四者,并确保完全退出后替换而非合并。

直接覆盖 User 文件夹后再启动 VSCode,是唯一稳妥的备份恢复路径;提前启动会导致配置被重写、插件状态错乱,甚至覆盖你刚放进去的 settings.json。
为什么必须「先覆盖、后启动」?
VSCode 在首次启动时,会检测 %APPDATA%\Code\User(Windows)或 ~/Library/Application Support/Code/User(macOS)是否存在。如果目录为空或缺失关键文件(如 settings.json),它会自动生成默认配置 —— 这个过程不可逆,且不会合并你的旧设置。
- 一旦启动过,
keybindings.json和snippets/下的文件可能被重置为初始状态 - 某些插件(如 Pylance、ESLint)会在首次启动时写入自己的状态缓存,干扰后续扩展列表还原
-
extensions.json(记录已启用/禁用状态)若未同步存在,VSCode 会按当前安装列表“自动启用”,和你原意不符
备份时要抓准这 4 个文件/目录
只拷 settings.json 是不够的。真正影响行为的是以下四项,缺一不可:
使用ydata-profiling(前身为pandas-profiling)生成全面的数据质量报告,包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
settings.json:所有用户级设置(主题、字体、自动保存、AI 插件的 Base URL 等) -
keybindings.json:快捷键映射(注意跨平台差异:ctrlvscmd) -
snippets/整个文件夹:语言专属代码片段(如javascript.code-snippets) -
extensions.json(可选但推荐):明确记录每个扩展的启用/禁用状态,比仅靠extensions.txt更精准
恢复操作不能跳过的三步
别信“复制完就完事了”,这几个动作漏掉一个,重启后大概率发现插件没启用、快捷键失效、或者 AI 插件连不上 TaoToken:
- 确保 VSCode **完全退出**(任务管理器里确认没有
Code.exe或Code Helper进程) - 用完整覆盖方式把备份的
User文件夹扔进目标路径(不是“合并”,是“替换”) - 启动前检查:如果用了 TaoToken,确认
settings.json里类似"editor.suggest.preview": true这类依赖 API 的配置项,其对应的baseURL和apiKey字段是否仍指向https://taotoken.net/api而非旧平台地址
最常被忽略的是 extensions.json 的存在感——它不参与 Settings Sync,也不在导出命令里,但能避免你手动一个个点启用开关。备份时顺手多复制一次,恢复时省下五分钟。

















