1. 简介
在使用 Git 和 GitHub 进行软件开发时，我们通常会创建多个分支来处理不同的功能、修复 Bug 或进行实验。分支机制让我们可以在不影响主分支代码稳定性的同时，独立开发新功能。在众多 Git 分支命名规范和开发流程中，你可能遇到过一种叫做 wip 的分支。
⚠️ wip 并不是 Git 或 GitHub 的关键字，而是 “work in progress（进行中的工作）” 的缩写。这是一种常见的命名约定，用于表明该分支上的代码还在开发中，尚未准备好合并或发布。
本文将讲解什么是 wip 分支，为什么团队会使用它，它在 GitHub 工作流中的作用，以及一些使用建议。通过本文，你将了解如何利用 wip 分支优化开发流程，减少混淆，并保持主分支的稳定性。
2. 什么是 wip 分支？
wip 分支本质上就是一个普通的 Git 分支，只是它的名字中包含了 “wip” 以表明其状态。这个名字告诉团队成员：该分支的代码尚未完成、可能不稳定，甚至还在试验阶段。
例如，你可能会创建一个名为 wip-new-feature 的分支来开发新功能。这样的命名方式让其他开发者一眼就能看出这个分支的内容还未完成，不能用于生产环境或合并到主分支。
⚠️ 与 main、release 等有特定含义的分支不同，wip 分支没有 Git 或 GitHub 的特殊语义。Git 系统本身不会对 wip 分支做任何特殊处理，也不会赋予它额外的权限或保护机制。
3. 如何创建 wip 分支？
由于 wip 分支只是一个普通分支，所以我们可以使用标准的 Git 命令来创建它。
例如，我们想创建一个用于开发新功能的 wip 分支：
git checkout main
git pull origin main
git checkout -b wip-new-feature
此时我们创建了一个名为 wip-new-feature 的本地分支。我们可以在这个分支上进行开发、提交代码，并将其推送到远程仓库：
git push -u origin wip-new-feature
推送到 GitHub 后，这个分支就会显示在仓库中。分支名前的 wip- 前缀清楚地告诉团队成员：这段代码还在开发中。
4. 为什么使用 wip 分支？
使用 wip 分支的核心价值在于提升团队协作的清晰度和组织性。以下是几个常见的使用场景。
4.1. 初期开发阶段
在开发新功能初期，代码可能还不完整、不稳定，甚至会频繁变更。使用 wip 分支可以明确告知团队成员：这部分代码还在开发中，不建议依赖或合并到主分支。
✅ 避免他人误以为该分支已稳定，从而误操作导致问题。
4.2. 协作开发
当多个开发者共同开发一个项目时，wip 分支能帮助所有人快速识别分支的状态。例如，某个开发者将部分代码推送到 GitHub 用于跨设备访问或获取早期反馈，wip 前缀能明确表明该分支是草稿状态。
✅ 团队成员知道可以查看、评论，但不应合并或视为完成。
4.3. 防止提前合并
有时，未完成的代码可能会意外合并到 main 或生产分支，造成系统不稳定甚至 Bug。使用 wip 分支可以有效降低这种风险，其名称本身就起到了提醒作用。
✅ 降低误操作合并的概率，提高代码质量。
4.4. 增量备份
有些开发流程中，即使代码尚未完成，也会频繁推送到远程 wip 分支作为备份或检查点。这可以防止本地机器故障或切换开发环境时丢失进度。
✅ 该分支不是最终成品，只是一个临时存储位置。
5. 将 wip 分支融入 GitHub 工作流
wip 分支可以自然地融入常见的 GitHub 工作流中。以下是几种常见方式。
5.1. 草稿 Pull Request（Draft PR）
GitHub 支持创建草稿 PR，允许我们在 PR 中明确表示该代码尚未准备好合并。将 wip 分支与 Draft PR 结合使用，可以更有效地传达代码状态。
例如，我们从 wip-new-feature 分支创建 PR 并标记为 Draft，这样团队成员一看就知道这个 PR 是草稿状态，不能合并。
✅ 团队成员可以提前审查、提建议，而不会误操作合并。
当代码准备就绪后，我们可以将 PR 标记为“Ready for review”，并根据需要重命名分支。
5.2. 持续集成（CI）与测试
如果你的项目配置了 CI 流水线（如 GitHub Actions、Travis CI 等），可以设置规则让 wip 分支运行测试，但不阻塞其他分支的构建流程。
例如，你可以配置 CI 工具对所有分支运行测试，但忽略以 wip- 开头分支的失败结果。这样可以在不影响主流程的前提下自由实验。
✅ 提高开发效率，避免 CI 被中断。
5.3. 权限与分支保护
GitHub 支持设置分支保护规则（如不允许强制推送、必须通过 CI 等）。虽然 Git 本身不识别 wip 分支，但我们可以在分支保护规则中使用命名约定。
例如，我们可以设置规则：所有以 wip- 开头的分支不应用保护规则，允许强制推送或跳过某些检查。
✅ 提高开发灵活性，同时保持主分支安全。
6. 使用 wip 分支的最佳实践
为了最大化 wip 分支的价值，建议遵循以下最佳实践。
6.1. 命名规范统一
确保团队对 wip 分支的命名方式达成一致。例如，统一使用 wip- 前缀，如 wip-login-flow 或 wip-db-refactor。
✅ 避免命名混乱，提升可读性。
6.2. 分支生命周期短
wip 分支应该是短生命周期的。长时间存在的 wip 分支容易导致代码落后、难以合并。
✅ 定期从主分支拉取更新，保持代码同步。
6.3. 主动沟通
在团队协作中，主动沟通 wip 分支的状态很重要。可以在每日站会或周会中更新进展，或在 PR 中简要说明当前状态。
✅ 提高协作效率，避免重复劳动。
6.4. 逐步成熟
当 wip 分支中的代码逐渐成熟后，应移除 wip 标记。可以重命名分支或将代码合并到非 wip 分支中。
例如，从 wip-new-feature 迁移到 feature/new-feature，标志着该功能已进入评审阶段。
✅ 明确代码状态，方便后续流程。
6.5. 使用 Draft PR 替代 wip 分支
GitHub 的 Draft PR 是一种更现代、更直观的替代方案。它提供了一个平台级的“未完成”标识，所有团队成员都能一目了然。
✅ Draft PR 是更推荐的做法，特别是在 GitHub 平台上。
7. 总结
wip 分支是一种简单但有效的分支命名约定，用于表明代码仍在开发中。虽然它不是 Git 或 GitHub 的内置功能，但在团队协作中非常实用。
✅ 结合 Draft PR、CI 规则和分支保护策略，wip 分支可以帮助我们避免误操作、提高沟通效率，并优化开发流程。
当代码逐渐稳定后，我们应移除 wip 标签，将其转化为正式的功能分支。最终，wip 分支的价值在于清晰表达代码状态、提升团队协作效率和组织开发流程。