移动/重命名VSCode项目文件夹时如何保留Local History记录

当项目从原路径path/to/project-folder-A移动、重命名到新路径new/path/to/project-folder-B时，默认时间线视图中的Local History条目会直接消失，前后对比如下：

• 移动/重命名前效果：
  
• 移动/重命名后效果：
  

同设备移动/重命名项目操作步骤 #

VSCode默认通过文件绝对路径关联本地历史记录，按以下操作即可保留全部历史条目：

• 完全退出VSCode，确保后台无相关运行进程
• 定位到本机VSCode本地历史存储根目录：
  • Windows：%APPDATA%\Code\User\History
  • macOS：~/Library/Application Support/Code/User/History
  • Linux：~/.config/Code/User/History
• 打开目录下的entries.json文件，该文件存储了所有Local History与文件路径的映射关系
• 全局替换文件内所有原项目路径字符串path/to/project-folder-A为新路径new/path/to/project-folder-B，注意路径分隔符需和当前系统匹配（Windows使用反斜杠\，macOS/Linux使用正斜杠/），替换完成后保存文件
• 将项目文件夹移动/重命名到目标路径，重启VSCode打开项目即可看到原有Local History条目正常加载

跨设备迁移项目操作步骤 #

跨设备迁移需要同步迁移Local History存储文件并修改路径映射：

• 在原设备上完全退出VSCode，复制前述History存储目录下的全部内容
• 将复制的内容粘贴到新设备对应的VSCode History目录下，如果新设备已有其他项目的本地历史，不要直接覆盖目录，将子文件、子文件夹合并到现有目录即可
• 打开新设备History目录下的entries.json，将其中所有原设备的项目绝对路径，替换为新设备上项目的实际存放绝对路径，保存后重启VSCode即可

备注：如果使用VSCode Insiders版本，路径中的Code目录需替换为Code - Insiders；VSCodium等其他基于VSCode的衍生版本，对应替换为自身的配置目录名即可。

目前官方尚未提供项目路径变更后自动关联本地历史的原生功能，相关功能需求已有反馈提交。

内容的提问来源于stack exchange，提问作者Omar