12 KiB

Raw Blame History

3.9 协作工具

无论是团队协同开发还是独自开发，都难免要使用一些软件管理工具。在软件开发过程中，除了常用的 IDE 外，还经常用到差分工具、版本管理工具、代码托管和协作工具。这其中比较有代表性的开源工具是：Meld、Git 和 Gitea。

3.9.1 Git 版本管理

Git 版本管理工具提供本地和远程版本管理功能。支持分支管理和 Tag 创建等。通常来讲，一个 Tag 对应一个稳定的软件版本。

使用 Git 前需要进行简单配置，在命令行中输入以下命令及参数设置 Git 用户名和 Email。

git config --global user.name "Your Name"
git config --global user.email "YourEmail@example.com"

3.9.1.1 创建仓库

软件版本管理依赖于软件仓库的概念，一个软件仓库包容了要进行版本管理的源码和 Release 发布等内容。

在要进行版本管理的目录下键入：

git init

命令，可完成软件版本仓库的创建操作，在创建完软件仓库后，该目录下会生成一个名为“.git”的隐藏文件夹，该文件夹下保存了软件的历史和分支等版本信息，通常不需要直接操作该目录。

3.9.1.2 添加管理文件

版本仓库所在文件夹下的文件并不是全部都会被 git 跟踪和管理。如果需要将该文件夹下将某个文件纳入到版本管理中，则需要通过 add 命令添加到 git 仓库中进行跟踪：

git add <file name>

例如：

git add main.c

3.9.1.2 Clone 仓库

更多的时候，不需要手动创建 git 仓库。git 仓库很可能已经存在于远端服务器或别人的计算机中，这时候我们只需要将其 clone 到本地即可：

git clone <URL>

例如：

git clone https://192.168.1.8/path/repo.git

git 支持 http、https、ssh 格式的 URL 访问。

3.9.1.3 提交变更

在修改代码或相关文件后，需要先将变更缓存到本地，这一步被称作 commit。带签名的提交命令如下：

git add .
git commit -s -m "Message"

3.9.1.4 时光穿梭

如果文件尚未 stash，可使用 checkout 命令撤回修改：

git checkout -- <file>

如果文件已 stash 但是没有 commit，可使用 reset 命令撤回修改：

git reset HEAD <file>

如果文件已经 commit，可使用下列命令：

git reset --soft <commit id>
git reset --hard <commit id>
git reset --hard HEAD~10
git revert <commit id>

注意 soft 与 hard 的区别主要在于 hard 不保留工作区中的内容，但是 soft 保留工作区中的内容。而 reset 与 revert 的区别在于 revert 是放弃指定提交的修改，但是会生成一次新的提交，需要填写提交注释，以前的历史记录都在，而reset是指将HEAD指针指到指定提交，历史记录中不会出现放弃的提交记录。

3.9.1.5 分支管理

通过以下命令创建新的本地分支：

git branch <branch name>

还可以通过以下命令查看分支情况：

git branch
git branch -a

使用下列命令切换到对应分支：

git checkout <branch name>

删除某分支的命令为：

git branch -d <branch name>

3.9.1.6 查看历史

版本管理提供的最主要的功能之一便是历史追溯，可以查看每一次变更的内容，相关提交的信息等。通过下列命令实现：

git show

3.9.1.7 Tag 节点

可以通过：

git tag

命令列出当前仓库中的所有标签，创建一个带附注的的标签则可以使用以下命令实现：

git tag -a <tag name> -m "Message"

还可以使用：

git tag <tag name>

创建一个轻量标签。

3.9.1.8 推送本地分支到远程分支

git push <repository> <local refspec>:<remote refspec>

如，推送本地的 new 分支与 origin 主机的 master 分支合并：

git push origin new:master

3.9.1.9 从远程分支更新本地分支

git pull <repository> <remote refspec>:<local refspec>

如，要取回 origin 主机的 new 分支，与本地的 master 分支合并：

git pull origin new:master

3.9.2 Gitea

Git 经常配合 TortoiseGit、VS Code、Git Hub 或 Gitea 等工具使用。Gitea 与 Git Hub 类似，可用于构建 Git 服务器，实现代码托管和项目管理。Gitea 的部署非常容易，使用方式又与 Git Hub 相像，这里以 Git 结合 Gitea 使用为例进行讲解。

以下假设服务器的地址为 https://192.168.1.8/。

3.9.2.1 账户管理

下面是一个典型的 Gitea 登陆界面：

Gitea 的用户可以自助注册。但为便于服务器的管理，我们的服务器不开放注册功能。用户账号由服务器管理员进行分配和管理。申请服务器账号需要向管理员提供有效的 E-mail 用于完成注册和验证验证。

当 E-mail 邮箱收到注册验证邮件后，点击 “reset your password” 链接修改密码并激活 Gitea 账号。

当密码修改完毕并完成账号激活后，就可以使用申请的邮箱和新密码进行登陆。登陆后通过个人“设置”来修改用户名称和头像。

3.9.2.2 仓库管理

每个账户都可以创建自己的代码仓库（创建仓库的数量有限制，可向管理员申请增加仓库数量）。通过以下两种方式都可以创建一个新的代码仓库。

接下来需要配置仓库管理者、仓库名称、仓库可见性、仓库描述、仓库忽略文件的类型模板、软件许可证，以及是否初始化仓库。

在上图中，我们创建了一个私有仓库，git 忽略文件选用了 C++ 项目的模板文件，并由服务器自动初始化好这个仓库。

如果项目是私有的，那么只有仓库“拥有者”和“协作者”可以看到这个代码仓库，其他人不可见；如果项目不是私有的，那么就是一个公开项目，任何人都可以看到这个项目。

git 忽略文件是一个名为 “.gitignore” 的文件，这个文件里是一些会被 git 版本管理系统忽略的文件的名称。C++ .gitignore 模板定义了可用于 C++ 项目的一些可被版本管理忽略的文件名称和类型。

如果没有选中“初始化存储库”选项，那么你需要手动 git init 这个仓库。如果选中了该选项，就不再需要手动 init，并且 gitea 会自动生成项目的 .gitignore 和 README.md 文件。

配置好仓库后，点击“创建仓库按钮”，该仓库即被创建到服务器上。

复制右侧红框中的连接，之后 git clone 这个连接，即可将 Gitea 服务器上创建的这个项目 clone 到本地。

点击“仓库设置”可进入仓库高级管理界面，在该界面可以修改仓库名称、转移仓库所有权、删除本仓库、设置分支保护等。

3.9.2.3 提交和获取变更

将仓库 clone 到本地后，可以任意修改，之后在本地进行 commit 操作，最后使用 git push 命令将修改提交到 Gitea 服务器。

如果 Gitea 服务器上该项目内容被别人修改了，我们可以使用 git pull 命令对本地仓库进行更新。

如果在你提交代码前，服务器上的代码已经发生了变化，那么你的提交会被禁止。这时候需要先从服务器获取更新，然后在本地 Merge 代码，之后再进行提交。

3.9.2.4 代码 Review

代码 Review 是软件开发过程中一项非常重要的工作，任何人都不应该随意的提交代码到软件仓库中，只有哪些经过专家评审过的代码才能被提交到正式仓库中。其他开发代码可以只存储到临时分支里。当开发代码足够成熟后，再发起向主干分支的合并请求。

Gitea 对代码 Review 的支持也是基于这样的理论指导。

在“仓库设置”中的“分支列表”里选择要保护的分支作为主干分支，Gitea 禁止对受保护的分支进行 push 操作。开发人员需要创建一个新的分支进行开发，开发完成后，基于新的分支发起 Merge 请求。仓库管理员会获得通知，并基于这个 Merge 请求进行代码 Review。如果代码合格，合并请求将会被通过，如果代码不合格，仓库管理员可以拒绝进行 Merge 操作。Merge 请求通过后，新的代码将被合并到主干代码中。