28、Git版本控制的实用指南-CSDN博客

Git版本控制的实用指南

1. 版本控制基础

在版本控制的时间轴底部，有两个默认选项：本地（Local）和基础（Base）。本地显示文件的当前版本，而基础显示最后一次提交的版本。当你对代码进行修改后发现一团糟时，比较基础版本和本地版本会很有用。你可以找出有问题的代码，并将其恢复到上一个版本的状态。

在基础版本之上，是按逆时间顺序排列的之前对仓库的提交记录。当你将光标移到时间轴中的某个条目上时，会显示该提交的关键细节，如日期和时间、注释以及执行提交的人员姓名。时间轴左右两侧的箭头指示了相应窗格中显示的内容，让你能够非常精细地控制要比较的版本。

2. 责备视图（Blame View）

Xcode与Git的集成让你无需担心幕后的操作。就像苹果的许多产品一样，它就是这么简单易用。但在后台，Xcode会向Git系统发送命令行消息来执行你要求的操作。其中有一系列命令，包括 git blame ，责备视图就是基于此命令来显示信息的。

“责备”这个词不太恰当，因为很多时候你并不是真的要责怪任何人，你只是想知道在项目中谁对代码做了哪些修改，以便向他们进一步询问。而且，给Xcode源代码控制中这个很酷的视图加上这么一个负面的词也不太公平。

要开启责备视图，再次点击版本编辑器按钮，会弹出一个菜单，选择“Blame”（参考对应操作系统的图标）。打开责备视图后，你就能明白为什么它在团队环境中如此强大。它会详细分析所选文件中的每一处更改，包括更改的时间和更改者。如果你对同事编写的某个方法不太确定，你就知道该和谁去讨论了。

当你将光标移到代码右侧详细区域的某个块上时，会出现一个带圆圈的“i”符号。点击这个符号会弹出一个窗口，提供更多信息，并让你有机会在比较视图中进一步分析更改。

3. 日志视图（Log View）

版本编辑器提供的第三种也是最后一种视图是日志视图。选择日志视图会显示一个标准编辑器和一个额外的栏，详细显示当前文件的更改历史以及相关注释。日志视图是版本编辑器中最简单的视图，因此你可能更常使用比较视图或责备视图。

4. 仓库分支

在使用Git进行版本控制的项目开发中，主分支（master branch）或主干（trunk）应始终用于保存准备发布的项目版本。当你想添加新功能时，你可以直接在主分支上继续工作，但如果之后需要修改代码来修复bug，你就没有一个好的版本可以更新，开发过程可能会陷入混乱。在这种情况下，你可以从主分支创建一个新分支，这样你就可以在与主分支完全隔离的环境中工作。当你对新分支的工作满意，准备将更改合并到发布版本时，再将该分支合并回主分支。

4.1 创建新分支

为了给HearMeNow应用程序添加新功能，我们创建一个名为“SlowDown”的新分支。主分支将保持不变，所有工作都将在新分支上进行。在这个新分支中，你将修改播放例程，将播放速度减慢到正常速度的一半，这在你录入听写内容、理解语速较快的人讲话或学习一门新语言时非常有用。

创建新分支的步骤如下：
1. 转到“Source Control” -> “HearMeNow” -> “Master” -> “New Branch”。
2. 在弹出的对话框中为分支命名（如“SlowDown”），然后点击“Create”。

Xcode会创建新分支并自动切换到该分支。从项目导航器中打开“ViewController.swift”文件，并确保你仍处于日志视图。此时你会发现，你现在正在“SlowDown”分支上工作，而不是主分支。

4.2 修改代码

现在有了单独的分支，你可以自由地修改代码，而不用担心破坏主分支上的原始可用项目。要降低播放速度，只需添加以下代码：

soundPlayer = AVAudioPlayer(contentsOfURL: url, error: &error)

if(error == nil)
{
    soundPlayer?.delegate = self
    soundPlayer?.enableRate = true
    soundPlayer?.rate = 0.5
    soundPlayer?.play()
}
else
{
    println("Error initializing player \(error)")
}

在将更改提交到当前分支之前，运行应用程序来测试新功能。录制一段内容并播放，如果一切正常，声音应该是正常速度的一半，听起来可能会有点慵懒或像喝醉了一样。当你对更改满意后，按照之前的方法提交更改，并添加合适的注释。

5. 合并分支

你已经在不影响主分支上工作解决方案的情况下完成了更改。现在，是时候将“SlowDown”分支与主分支合并，并发布应用程序的新版本了。

5.1 比较文件

在合并两个分支之前，先比较一下两个分支中的“ViewController.swift”文件。打开版本编辑器和默认的比较视图，然后从项目导航器中选择“ViewController.swift”文件。默认情况下，Xcode会在左侧显示本地版本，右侧显示最后一次提交的版本。这在当前情况下没什么用，因为它们实际上是相同的。在右侧窗格的底部，点击“SlowDown”，会弹出一个菜单，将鼠标悬停在“Master”上，然后选择最新版本。这样就会加载你第一次提交的“ViewController.swift”版本。

当另一个版本的文件显示出来后，向下滚动到你修改“playPressed”方法的地方。你会看到Xcode突出显示了你所做的更改，这表明主分支中没有你刚编写的代码。

5.2 选择合并方式

现在你确定了两个文件之间存在差异，可以进行分支合并了。再次打开源代码菜单，将鼠标悬停在“HearMeNow – SlowDown”项上。Xcode提供了两种合并分支的选项：
- Merge From Branch ：如果你当前正在目标分支（即你想添加更改的分支）上工作，可以选择此选项，然后选择包含你要合并更改的源分支。
- Merge Into Branch ：如果你当前正在源分支（即包含更改的分支）上工作，应该选择此选项，然后选择要合并到的目标分支。

在这种情况下，我们需要选择“Merge Into Branch”。选择后，会出现一个屏幕让你选择要合并到的目标分支，选择主分支并点击“Merge”。

5.3 完成合并

此时会再次显示代码比较视图，但这次选项不同。在左右窗格之间有一个滑块，而不是提交更改时出现的编号选项，这是方向滑块，用于确定如何合并文件。由于你只修改了“SlowDown”分支，而主分支未被修改，所以需要将更改从右向左合并，这也是当前默认的选择。

如果你和同事分别在不同的分支上独立添加新功能，你可能需要先将这两个分支合并，再将它们合并到主分支。或者，你可以将其中一个分支与主分支合并，创建一个新的主分支，让你的同事将他们的分支与新分支合并进行测试，最后再将该分支合并到主分支。

当你确认滑块的深色部分指向较新的“SlowDown”分支作为源时，点击“Merge”。此时可能会提示你启用或禁用快照，你可以根据自己的情况选择。完成选择后，合并操作完成，你将回到Xcode中主分支的“ViewController.swift”文件。运行应用程序，你会发现从主分支构建的应用程序具有在“SlowDown”分支中添加的半速播放功能。

6. 删除分支

成功合并分支后，为了保持仓库的整洁，通常会删除不再需要的“SlowDown”分支。操作步骤如下：
1. 转到“Source Control” -> “HearMeNow” -> “Master” -> “Configure HearMeNow”，选择“Branches”选项卡。
2. 从列表中选择“SlowDown”分支，然后点击左下角的“–”图标。
3. 在弹出的确认删除对话框中点击“Delete Branch”，该分支将被永久删除。

7. 使用远程仓库

到目前为止，我们主要介绍了使用本地Git仓库，但这并不是唯一的选择。有许多在线解决方案可用于托管或备份你的Git仓库，如非常流行的GitHub、Bitbucket等。奇怪的是，对于团队来说，最好的Git解决方案之一是微软的Visual Studio Online，因为它内置了适用于采用Scrum敏捷方法的团队的工具。

使用这些在线服务，你不仅能获得本地Git仓库的所有好处，还能与全球的开发者进行协作。如果你在完成应用程序或游戏时缺乏所需的专业知识，可以将仓库推送到网上，寻求朋友的帮助来添加那些很棒的功能。

在开源软件时代，越来越多的人转向在线Git仓库来与世界分享他们的源代码。当你看到人们基于你的代码开发出有趣的新应用时，将你的软件公开可能会带来极大的回报。但在线并不意味着对所有人开放，你可以创建私人仓库，并根据自己的喜好限制访问权限。

7.1 注册GitHub账户并创建仓库

注册GitHub账户非常简单，因为网站的设计很贴心。访问http://github.com，注册表单就在首页。填写用户名、电子邮件和密码，然后点击“Sign Up For GitHub”按钮。如果你已经有账户，点击右上角的“Sign In”按钮。

登录GitHub后，会显示启动页面，点击“New Repository”按钮。创建新仓库时，只需给仓库命名，并选择是公开还是私有仓库。命名可以根据项目名称来，如“HearMeNowSwift”，如果是公开仓库，添加描述会很有帮助。添加完名称后，点击“Create Repository”按钮。

创建仓库后，会进入仓库页面，此时仓库基本为空，但需要注意快速设置框中的HTTP地址。点击地址末尾的“Copy To Clipboard”按钮，复制仓库地址，以便添加到Xcode中。

7.2 将GitHub仓库添加到Xcode

将远程仓库添加到Xcode有两种方法：

7.2.1 在仓库配置中添加远程仓库

转到“Source Control” -> “HearMeNow” -> “Master” -> “Configure HearMeNow”，选择“Remotes”选项卡。
点击左下角的“+”符号，然后点击“Add Remote”。
给远程仓库一个参考名称，粘贴从GitHub快速设置框中复制的地址。
点击“Add Remote”将参考添加到Xcode。

这种方法的一个局限性是，它不允许你添加写入仓库所需的GitHub用户名和密码，这就引出了第二种方法。

7.2.2 使用Xcode偏好设置添加远程仓库

这是我推荐的方法，通常也是让仓库准备好投入使用最快的方法。步骤如下：
1. 转到“Xcode” -> “Preferences”（⌘ + ,）。
2. 当偏好设置窗口出现时，选择“Accounts”选项卡。
3. 在左侧列中，选择你刚刚添加的GitHub仓库的参考。
4. 在“User Name”和“Password”字段中输入你的GitHub凭证。当你输入用户名并点击密码框时，Xcode会尝试在线验证这些信息。
5. 输入完详细信息后，点击左上角的红点关闭偏好设置窗口。

通过以上步骤，你就可以很好地掌握Git的版本控制，包括本地操作和远程仓库的使用，提高项目开发的效率和协作性。

8. 总结与展望

8.1 Git操作总结

8.2 未来协作场景

在实际项目开发中，团队协作会面临更多复杂的场景。下面用mermaid流程图展示一种可能的协作流程：

graph LR
    classDef startend fill:#F5EBFF,stroke:#BE8FED,stroke-width:2px;
    classDef process fill:#E5F6FF,stroke:#73A6FF,stroke-width:2px;
    classDef decision fill:#FFF6CC,stroke:#FFBC52,stroke-width:2px;

    A([开始项目]):::startend --> B(主分支开发):::process
    B --> C{是否有新功能需求}:::decision
    C -->|是| D(创建新分支):::process
    D --> E(在新分支开发新功能):::process
    E --> F{功能开发完成?}:::decision
    F -->|是| G(合并新分支到主分支):::process
    G --> H(发布新版本):::process
    C -->|否| I(继续主分支维护):::process
    I --> J{是否有bug修复需求}:::decision
    J -->|是| K(创建修复分支):::process
    K --> L(在修复分支修复bug):::process
    L --> M(合并修复分支到主分支):::process
    M --> H
    J -->|否| B

这个流程图展示了一个典型的项目开发流程，包括新功能开发和bug修复。团队成员可以根据实际情况创建不同的分支，独立进行开发和修复工作，最后将更改合并到主分支。

8.3 持续学习建议

Git是一个功能强大的版本控制系统，本文只是介绍了其基本操作和常见应用场景。如果你想深入学习Git，可以进一步研究以下方面：
- 高级分支管理 ：学习如何处理复杂的分支结构，如多级分支、长期分支和短期分支的管理。
- 冲突解决 ：当多个分支的更改发生冲突时，如何有效地解决冲突，确保代码的一致性。
- 钩子脚本 ：利用Git的钩子脚本实现自动化流程，如代码检查、自动部署等。
- 分布式协作 ：了解如何在分布式团队中更好地使用Git进行协作，包括远程仓库的管理和同步。

通过不断学习和实践，你将能够更加熟练地使用Git，提高项目开发的效率和质量。希望本文能为你在Git的学习和使用中提供一些帮助，祝你在软件开发的道路上取得更好的成绩！