如何修改已有Git项目的目录至子文件夹（保留提交历史）

完全可以在不新建项目的前提下实现，核心是通过Git工具重写提交历史，把所有文件移动到指定子文件夹。以下是具体步骤：

操作步骤 #

• 先克隆项目的裸仓库（确保操作安全，避免影响本地工作区）：

  git clone --bare https://github.com/你的用户名/你的仓库名.git
  cd 你的仓库名.git
  

• 使用git filter-repo（官方推荐替代旧的filter-branch）重写历史，将所有文件迁移到目标子文件夹：

  git filter-repo --to-subdirectory-filter 目标子文件夹名
  

  示例：如果要把项目移到VSProject文件夹，命令就是git filter-repo --to-subdirectory-filter VSProject
• 强制推送到远程仓库（这会覆盖远程的提交历史，操作前务必确认没有未同步的重要修改）：

  git push --force origin main
  

  （如果你的主分支是master，替换成master即可）
• 本地环境更新：重新克隆仓库，或者在本地现有仓库执行强制拉取：

  git pull --force origin main
  

重要注意事项 #

• 操作前必须备份原仓库：重写提交历史是不可逆操作，一旦出错很难恢复
• 通知协作者：如果有其他开发者协作，需要让他们重新克隆仓库，或者在本地执行git fetch origin后用git reset --hard origin/main同步（此操作会丢失本地未提交的修改）
• 解决大文件问题：迁移完成后，建议用git lfs管理体积较大的配置文件，防止仓库再次膨胀

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