在团队协作和软件开发过程中，合理的版本库管理能够提高开发效率，并确保代码的安全性和可维护性。本章将介绍如何谈论服务器、发布版本库、管理版本库结构，以及在分布式环境下进行团队协作。

14.1 谈谈服务器

Git 版本库通常存储在远程服务器上，以便多个开发者可以共享和协作。常见的 Git 服务器托管方式包括：

1. 自建 Git 服务器：使用 Git 裸仓库（bare repository）在公司内部搭建服务器。
2. 云端 Git 托管：如 GitHub、GitLab、Bitbucket 等平台提供 Git 服务器托管服务。
3. 混合模式：部分项目存储在私有 Git 服务器，部分存储在公共平台。

在选择 Git 服务器时，需要考虑访问权限、稳定性、安全性和备份策略。

14.2 发布版本库

发布版本库是让其他开发者能够访问和使用项目代码的过程。

14.2.1 带访问控制的版本库

为了保证代码安全，Git 支持访问控制，限制哪些用户可以查看或修改仓库内容。可以通过 SSH 认证、HTTPS 认证或 Git 服务器上的权限管理来控制访问。

14.2.2 分权限名读取访问的版本库

Git 服务器可以使用不同的权限级别，例如：

• 只读权限（read-only）：可以克隆代码，但无法推送更改。
• 写入权限（read-write）：可以推送更改，影响仓库内容。

使用 git config 限制用户权限：

git config core.sharedRepository group

14.2.3 分权限名写入权限的版本库

在 GitHub 和 GitLab 等平台上，可以通过组织（organization）和团队（team）功能，细粒度地管理不同成员的访问权限。

14.2.4 在 GitHub 上发布版本库

GitHub 是最流行的 Git 托管平台，发布版本库的基本步骤如下：

1. 在 GitHub 创建新仓库。

2. 在本地初始化 Git 仓库：

   git init
   git add .
   git commit -m "初始化项目"

3. 关联 GitHub 远程仓库并推送代码：

   git remote add origin https://github.com/user/repo.git
   git push -u origin main

14.3 有关发布版本库的建议

• 使用 README 说明项目：提供项目介绍和使用指南。
• 设置 .gitignore 文件：排除不必要的文件（如编译生成的文件）。
• 定期推送代码：保持远程仓库与本地代码同步。
• 为重要版本打标签：使用 git tag 创建版本标签，以便快速切换到特定版本。

14.4 版本库结构

14.4.1 共享的版本库结构

共享版本库结构通常适用于团队协作，所有开发者都推送代码到同一个远程仓库。例如：

/repo.git (裸仓库)
    ├── main
    ├── develop
    ├── feature/*

14.4.2 分布式版本库结构

分布式 Git 允许多个远程仓库，每个开发者可以有自己的远程仓库。例如：

origin -> GitHub 远程仓库
upstream -> 主仓库
developer-A -> A 的远程仓库
developer-B -> B 的远程仓库

14.4.3 版本库结构示例

常见 Git 版本库结构包括：

• 单一主干（Trunk-based Development）
• Git Flow 工作流（包含 main、develop、feature/* 分支）
• Fork + Pull Request（PR）模式

14.5 分布式开发指南

14.5.1 修改公共历史记录

在多人协作项目中，应避免修改已推送的提交，否则可能导致其他开发者的代码冲突。如果必须修改已推送的提交，可使用 git rebase 并强制推送：

git push --force

14.5.2 确定提交和发布的步骤

1. 在本地开发并提交更改：

   git add .
   git commit -m "添加新功能"

2. 推送到远程仓库：

   git push origin feature-branch

3. 创建 Pull Request 并请求代码审查。

4. 合并后删除 feature 分支：

   git branch -d feature-branch
   git push origin --delete feature-branch

14.5.3 没有唯一正确的历史记录

Git 允许开发者根据团队需求调整工作流，例如使用 git merge 或 git rebase 来管理提交历史。

14.6 清楚你的位置

在 Git 的分布式开发模式中，理解你的角色至关重要。

14.6.1 上下游工作流

• 上游（Upstream）：通常是主仓库，所有开发者从这里拉取代码。
• 下游（Downstream）：开发者自己的远程仓库，包含个人开发的代码。

14.6.2 维护者和开发人员的角色

• 维护者（Maintainer） 负责审核和合并代码。
• 开发者（Developer） 负责开发新功能并提交 PR。

14.6.3 维护者-开发人员的交互

常见协作流程：

1. 开发者 Fork 远程仓库。
2. 克隆到本地并创建新分支。
3. 开发新功能并推送到 Fork 仓库。
4. 提交 PR，请求合并到上游仓库。
5. 维护者审查代码并决定是否合并。

14.6.4 角色的两面性

在不同的项目中，开发者也可能充当维护者的角色，例如开源项目的核心贡献者。

14.7 多版本库协作

14.7.1 履行你自己的工作区

在本地工作区中，确保代码始终与远程仓库保持同步，避免合并冲突。

git pull origin main

14.7.2 从哪里开始你的版本库

通常，开发者可以从官方仓库（Upstream）克隆代码，或 Fork 仓库后进行独立开发。

14.7.3 转换到不同的上游版本库

当上游仓库发生变更时，可以使用 git remote 重新指定远程仓库：

git remote set-url origin <新仓库地址>

14.7.4 使用多个上游版本库

Git 允许一个本地仓库同时跟踪多个远程仓库，例如：

git remote add upstream https://github.com/org/repo.git

然后获取上游仓库的更新：

git fetch upstream

14.7.5 复刻项目

如果需要复制现有项目的所有历史，可以使用 git clone --mirror 创建一个完整副本：

git clone --mirror https://github.com/user/repo.git

结论

本章介绍了 Git 版本库管理的关键概念，包括服务器管理、版本库发布、分布式开发指南以及多版本库协作。掌握这些知识，有助于更好地管理团队协作，提高开发效率。