VS code, 最近打开过哪些项目或文件夹,把这些备份下来,到另外一台电脑上恢复
VS code, 最近打开过哪些项目或文件夹,把这些备份下来,到另外一台电脑上恢复
VS Code 完整迁移「最近打开项目 / 文件夹」到新电脑(两种方案:云端自动同步 / 离线手动拷贝)
方案一:官方设置同步(推荐,最简单,自动同步全部最近列表)【可用,可行】
该功能会同步UI 状态(最近打开文件夹、历史窗口)、插件、配置、快捷键,换电脑登录账号一键恢复。
旧电脑操作(上传历史记录)
-
打开 VS Code,左下角齿轮「管理」→ 打开设置同步(Turn on Settings Sync)

-
勾选同步项,务必勾选 UI State(UI 状态)(存储所有最近打开项目)
-
选择登录:微软账号 / GitHub 账号,浏览器完成授权登录
-
登录成功后自动上传,右下角提示「上传成功」,所有最近项目列表同步云端
新电脑操作(恢复)
- 新电脑安装 VS Code,同样打开「设置同步」,登录同一个账号
- 自动下载所有同步数据,重启 VS Code 后:
文件 → 打开最近,和旧电脑完全一致
注意:如果两台电脑系统路径不一样(比如 Windows→Mac),项目会显示灰色,只需重新映射文件夹即可打开。
方案二:离线手动备份(无网络 / 内网电脑,只迁移最近项目列表)
所有「最近打开文件夹 / 工作区」全部存在文件
state.vscdb,复制这个文件就能完整迁移历史列表。第一步:旧电脑备份(必须完全关闭 VS Code)
- 彻底关闭所有 VS Code 窗口(任务管理器结束所有 Code 进程)
- 根据系统打开对应目录,找到
state.vscdb文件:
Windows
- Win+R,粘贴路径回车:
%APPDATA%\Code\User\globalStorage文件:state.vscdb
Mac
- Finder 按
Shift+Command+G,粘贴:~/Library/Application Support/Code/User/globalStorage文件:state.vscdb
Linux
~/.config/Code/User/globalStorage- 复制
state.vscdb到 U 盘 / 硬盘备份
第二步:新电脑恢复
- 新电脑完全关闭 VS Code
- 找到新电脑同路径的
globalStorage文件夹 - 把备份的
state.vscdb覆盖替换原有文件 - 重启 VS Code,「打开最近」列表和旧电脑一模一样
补充:完整全套备份(不仅历史,连插件 + 配置一起迁移)
如果想一次性迁移所有配置、插件、最近项目,直接复制整个
User 文件夹:- Windows:
%APPDATA%\Code\User - Mac:
~/Library/Application Support/Code/User关闭 VS Code 后覆盖新电脑对应目录,重启全部还原。
方案三:工作区文件备份(分组项目一键打开)
适合固定一组项目批量保存,不受电脑路径限制
- 旧电脑打开多个项目文件夹
- 文件 → 将工作区另存为,保存
.code-workspace文件 - 把这个文件拷贝到新电脑,双击直接打开全部项目
缺点:只能保存当前打开的一组项目,不能还原全部历史记录。
常见问题
- 恢复后项目灰色打不开
新旧电脑磁盘路径不同,右键项目→移除文件夹,再重新添加本地文件夹即可。
- 复制 state.vscdb 后列表没变化
VS Code 后台进程没关干净,任务管理器结束所有 Code 进程再覆盖文件。
- 离线电脑无法登录同步
直接用方案二手动拷贝
state.vscdb文件。
===================================
一、先搞懂:为什么看不到「上传成功」弹窗
新版 VS Code 原生同步不会弹出大弹窗提示上传成功,只会:
- 左下角齿轮旁出现旋转同步小图标,转完消失 = 同步完成
- 无任何文字弹窗,很多人误以为没上传
- 必须手动触发一次强制同步,确认 UI 状态(最近项目)上传云端
步骤 1:手动强制上传(确认把最近项目备份到云端)
-
快捷键
Ctrl+Shift+P(Mac:Cmd+Shift+P)打开命令面板 -
输入:
设置同步:立即同步/Sync: Trigger Sync,回车执行同步活动面板 -
打开侧边「同步活动」面板,能看到一行 UI State 记录 = 最近项目列表已上传
UI State 就是存储「打开最近文件夹 / 项目」的核心同步项,没勾选就同步不了!
步骤 2:检查是否勾选了 UI State(最常见失败原因)
-
左下角齿轮 → 备份和同步设置
-
点「配置」,必须勾选 UI State同步勾选界面
-
没勾选 UI State,同步永远不会备份你的最近项目列表,新电脑看不到历史记录
步骤 3:登录异常、同步卡住修复(转半天不动)
情况 A:登录失效 / 凭据缓存冲突(Windows)
- 完全关闭 VS Code
- Win 搜索「凭据管理器」→ Windows 凭据
- 删除所有带
vscode、code、Microsoft Account的条目 - 重启 VS Code,重新登录账号,再执行「立即同步」
情况 B:网络 / 浏览器授权失败
打开设置 JSON 修复登录弹窗:
Ctrl+,打开设置,右上角打开settings.json- 粘贴保存:
json
"microsoft-authentication.implementation": "msal-no-broker"
- 重启 VS Code 重新登录,走浏览器授权流程
情况 C:本地云端冲突,弹出合并 / 替换
出现弹窗时选 上传本地配置到云端(Upload),把本机全部最近项目覆盖云端记录。
二、云端同步始终不行?用离线备份(100% 能迁移最近项目)
不用依赖账号,直接复制存储最近项目的数据库文件,换电脑覆盖即可:
旧电脑备份(完全关闭 VS Code)
- Windows:Win+R 输入
%APPDATA%\Code\User\globalStorage - Mac:
Shift+Command+G输入~/Library/Application Support/Code/User/globalStorage - 复制文件
state.vscdb到 U 盘 / 硬盘
新电脑恢复
- 彻底关闭所有 VS Code 窗口、结束后台进程
- 打开同路径
globalStorage文件夹 - 把备份的
state.vscdb覆盖原文件 - 重启 VS Code → 文件→打开最近,和旧电脑完全一致
三、两种方案对比(按需选择)
表格
| 方案 | 优点 | 缺点 |
|---|---|---|
| 官方设置同步 | 自动云端、多设备实时更新 | 网络 / 登录问题容易卡住,无明显成功提示 |
| 离线复制 state.vscdb | 离线可用、100% 迁移历史列表、不受账号限制 | 换电脑路径灰色,需重新添加文件夹 |
四、新电脑恢复注意点
- 云端同步:登录同一个账号,执行「立即同步」,等待 UI State 下载完成
- 离线文件恢复:项目路径灰色是因为磁盘盘符 / 文件夹名称变了,右键移除文件夹,重新本地添加即可正常打开
- 操作前务必完全关闭 VS Code,否则文件被占用,同步 / 复制全部失效
==================================
没有同步: 文件--打开最近的文件
核心问题先说清楚
官方设置同步(Settings Sync)根本不会同步「文件→打开最近」里的文件夹列表Visual Studio Code!
UI State 只同步界面布局、侧边栏状态、最近命令,不同步历史打开的项目路径,这就是你同步完看不到旧电脑项目的根本原因。
唯一 100% 有效的离线迁移方案(必成)
【下面的方法 不行】
一、旧电脑备份(导出全部最近项目记录)
- 完全关闭所有 VS Code 窗口,任务管理器结束所有 Code 进程
- 打开文件夹:
- Windows:Win+R 输入
-
%APPDATA%\Code\User\globalStorage - Mac:访达按
Shift+Command+G -
~/Library/Application Support/Code/User/globalStorage
- 复制里面的
state.vscdb文件到 U 盘 / 移动硬盘,这就是存所有最近打开文件夹的数据库。
二、新电脑恢复
- 新电脑彻底关闭 VS Code
- 打开上面同路径的
globalStorage文件夹 - 把备份的
state.vscdb直接覆盖替换原有文件 - 重启 VS Code → 文件 → 打开最近,所有旧项目全部出现 【不行】
三、出现灰色打不开怎么办?
新旧电脑磁盘盘符 / 文件夹路径不一样,解决:
右键灰色项目 → 从最近列表移除,再手动打开本地对应文件夹即可。
如果你坚持想用云端同步(补充补救)
同步功能本身不存历史项目,只能用插件辅助:
- 旧电脑安装插件 Project Manager
- 把所有常用项目添加收藏(Save Project)
- 开启设置同步,插件配置会同步云端
- 新电脑登录同账号,自动同步收藏项目,一键跳转
两种方案对比
表格
| 方式 | 能否迁移全部最近项目 | 优缺点 |
|---|---|---|
| 复制 state.vscdb(推荐) | ✅ 完整还原全部历史 | 离线可用,不受账号网络限制;路径会灰色需重开 |
| 官方设置同步 | ❌ 不迁移历史文件夹 | 仅同步配置、插件、界面布局,丢失最近项目列表 |
| Project Manager 插件 | ✅ 仅手动收藏的项目 | 云端同步,不会灰色,但需要手动添加项目 |
避坑关键点
- 同步看不到上传成功是正常现象,新版无弹窗,只有旋转云朵图标;
- 同步开了也拿不到「打开最近」列表,不要反复折腾同步;
- 复制
state.vscdb必须完全关闭 VS Code,文件占用会导致覆盖失效。

浙公网安备 33010602011771号