Perforce 迁移到 Git

学完这篇你会掌握什么

• 理解 Perforce 迁移到 Git 的核心作用和适用场景
• 掌握 Perforce 迁移到 Git 的基本用法和常用参数
• 使用 git-p4 将 Perforce 仓库完整迁移到 Git，保留分支结构、提交历史和作者信息。
• 理解 概述 相关的概念
• 掌握 前置检查 相关的操作
• 知道在什么场景下使用该命令，什么场景下避免使用

先想一个问题

你的团队正在从其他版本控制系统迁移到 Git，或者需要在不同 Git 平台之间迁移代码和历史。你担心迁移过程中会不会丢失提交记录或作者信息。

概述

Perforce（Helix Core）是大型企业中常用的版本控制系统。git-p4 是 Git 官方提供的双向桥接工具，支持从 Perforce 迁移到 Git。

前置检查

# 确认已安装 git-p4
git p4 help

# 确保有 Perforce 仓库的访问权限
p4 info

# 检查 Perforce 客户端配置
p4 client -o

准备工作

1. 创建 Perforce 映射

# 定义要迁移的 Perforce 仓库路径
P4_PATH="//depot/main/..."

2. 配置作者映射

创建从 Perforce 用户到 Git 作者信息的映射文件 authors.txt：

perforce_user1 = Alice <alice@example.com>
perforce_user2 = Bob <bob@example.com>

迁移流程

方法一：完整迁移（保留全部历史）

# 完整克隆 Perforce 仓库到 Git
git p4 clone //depot/main/... --destination=my-repo

# 使用作者映射
git p4 clone --authors-file=authors.txt //depot/main/... my-repo

方法二：增量迁移（适合大型仓库）

# 先迁移最近的部分历史
git p4 clone --max-changes=1000 //depot/main/... my-repo

# 再增量获取更多
cd my-repo
git p4 sync

方法三：迁移指定标签

# 迁移时包含标签
git p4 clone --use-client-spec --detect-labels //depot/main/... my-repo

分支迁移

Perforce 的分支模型与 Git 不同。Perforce 分支通常是目录级别的副本。

# 手动映射 Perforce 分支到 Git 分支
git p4 clone //depot/main/... main-repo

# 迁移特性分支
git p4 clone //depot/feature/... --ref=refs/heads/feature feature-repo

迁移后检查

# 验证提交历史
git log --oneline --graph --all

# 检查作者信息
git shortlog -sne

# 验证文件完整性
git fsck

# 统计迁移数据
git count-objects -v

常见问题

大文件处理

# 迁移前清理大型二进制文件
# 考虑使用 Git LFS 管理
git lfs track "*.psd" "*.bin"

权限信息丢失

Perforce 的文件权限模型（-w 等）无法映射到 Git。建议：

1. 迁移后复查敏感文件的权限
2. 使用 .gitattributes 配置必要的权限

继续学习

1. migration/svn-to-git — SVN 迁移到 Git
2. migration/hg-to-git — Mercurial 迁移到 Git
3. migration/platform-migration — Git 托管平台间迁移

给你的练习

1. 在一个测试仓库中练习该命令的基本用法，观察执行前后的状态变化
2. 尝试该命令的不同参数选项，对比输出结果的差异
3. 模拟一个需要使用该命令的实际场景，完整走一遍操作流程

延伸阅读

沿着同一主题继续深入：

• git filter-repo 仓库重写深入
• Mercurial 到 Git 迁移指南
• 代码仓库迁移策略指南