如何将Perforce仓库中最近n次提交合并至Git仓库？

准备工作 #

• 确保本地已安装git-p4工具（Git默认自带，未安装可补充安装）
• 进入本地Git仓库目录
• 确认可正常访问目标Perforce仓库，明确对应仓库路径（例如//depot/your-project/dev/...）

步骤1：创建临时分支存放Perforce提交 #

先创建临时分支，避免直接改动主开发分支：

git checkout -b p4-import-temp

步骤2：拉取Perforce最近n次提交 #

首先查询Perforce中最近n次提交的变更列表（CL）范围：

p4 changes -n 5 //depot/your-project/dev/...

将命令中的5替换为你需要的提交次数n，执行后会得到对应的CL编号范围（比如CL1001到CL1005）。

接着用git-p4同步该范围的提交到临时分支：

git p4 sync //depot/your-project/dev/...@1001,1005

同步完成后，临时分支中就会包含Perforce的这n次提交。

步骤3：合并到Git主分支 #

切换回Git的主开发分支（例如main）：

git checkout main

执行合并操作：

git merge p4-import-temp

若遇到冲突，手动修改冲突文件后，执行以下命令继续合并：

git add .
git merge --continue

如果希望单独保留每个Perforce提交的独立记录，也可以使用cherry-pick逐个导入：

# 查看临时分支的提交哈希
git log p4-import-temp --oneline -n
# 通过哈希范围导入提交
git cherry-pick <第一个提交哈希>..<最后一个提交哈希>

冲突处理同上，解决后执行git cherry-pick --continue即可。

步骤4：清理临时分支（可选） #

合并完成且确认无误后，可删除临时分支：

git branch -D p4-import-temp

注意事项 #

• 同步前请确保Git主分支已拉取到最新状态，减少冲突概率
• 操作前建议备份本地Git仓库，避免操作失误导致数据丢失
• 若Perforce与Git的分支结构存在差异，需将命令中的Perforce路径替换为对应分支的路径
• git-p4会自动将Perforce提交转换为Git格式，若作者信息不符合要求，可提前通过git config user.name和git config user.email设置

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