浅克隆Git仓库修改最后提交并推送，如何保留远程历史？

你可以通过以下步骤，在仅克隆单个提交的前提下，改写最后一次提交并保留远程仓库的完整历史：

步骤详解 #

1. 浅克隆仓库：仅拉取远程分支的最新提交

   git clone --depth 1 <你的仓库地址>
   cd <仓库目录>
   

2. 获取远程最新提交的父哈希：
   浅克隆已经包含了远程最新提交的元数据（包括父提交哈希），直接提取即可，无需下载父提交的内容：

   # 替换 main 为你的目标分支名
   PARENT_HASH=$(git log -1 --pretty=%P origin/main)
   

3. 进行代码修改并暂存：

   # 执行你的修改操作...
   git add .
   

4. 改写提交并指定父节点：
   使用 --parent 参数让新提交继承原远程提交的父节点，确保历史衔接：

   git commit --amend -m "你的提交信息" --parent="$PARENT_HASH"
   

5. 安全强制推送：
   用 --force-with-lease 确保推送时远程没有未同步的变更，避免误覆盖：

   git push --force-with-lease origin main
   

原理说明 #

浅克隆的 --depth 1 会下载远程最新提交的完整元数据（包括父哈希、提交信息等），但不会下载该提交对应的文件内容之外的历史数据。通过手动指定父哈希，改写后的提交会和远程仓库的原有历史形成正确的父子关系，推送后仅替换远程的最后一次提交，其余历史完全保留。

注意事项 #

• 确保目标分支名正确（比如替换 main 为 master 或你实际使用的分支）
• 如果远程最新提交是仓库的根提交（无父节点），PARENT_HASH 会为空，此时直接执行 git commit --amend 即可，无需 --parent 参数
• --force-with-lease 是安全的强制推送方式，它会检查远程分支是否和你本地跟踪的版本一致，若有他人提交会终止推送，避免冲突

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