Git Bash 提交代码的正确姿式

项目经验，如需转载，请注明做者：Yuloran (t.cn/EGU6c76)

前言

本文介绍如何使用 Git Bash 命令行，提交代码、解决冲突，以及如何避免冲突。有助于理解 Android Studio 的 VCS 背后的原理。

检出代码

检出远程仓库

git clone https://github.com/Yuloran/GitTutorial.git
复制代码

能够检出 origin/master 分支到本地，这是 GitHub 建立仓库时默认的 主机名/分支名。使用 git branch -vv 查看本地分支状态：

可见，本地分支名为 master，关联的远程分支名为 origin/master（origin 是主机名，master 是分支名）。

检出远程分支

不少时候，配置管理员须要新建不少远程分支，以进行同一项目不一样版本的并行开发。好比，有的分支用于需求开发，有的分支用于 Bug 修复等。此时，咱们须要检出各自对应的分支，修改并提交代码。

同步远程分支

管理员新建远程分支后，咱们须要先同步一下远程分支，才能看到新建的分支：

如上图所示，先使用 git branch -a 查看本地和远程全部分支，发现并无管理员新建的 bug_fix 分支，此时输入 git fetch，提示有一个新分支 bug_fix。再次输入 git branch -a 查看全部分支：

嗯，确实多了一个 bug_fix 分支。

检出远程分支

git checkout -b bug_fix -t remotes/origin/bug_fix
复制代码

checkout -b 表示新建本地分支，bug_fix 为本地分支名，你也能够起别的名字。-t 表示追踪远程分支（track），remotes/origin/bug_fix 为远程分支名，查看检出结果：

输入 git branch 查看当前所在的本地分支：

输入 git status 查看当前分支状态：

提示你目前修改是最新的，没有任何修改能够提交。

提交代码

不良习惯

不少开发人员，喜欢在一个本地分支上，连续提交代码。这是一个很很差的习惯，尤为是在多人协做的状况下。这会致使每笔提交之间存在依赖关系，即便每笔修改之间毫无瓜葛。进而可能致使 merge 冲突、cherry-pick 合入冗余代码。并且，若是你忽然发现，上上一笔提交有问题的时候，我以为你可能有种想 shi 的感受。

正确姿式

保留一个本地分支，专门用于同步代码。

好比，咱们如今须要在 master 分支上作一个需求，首先输入 git status 查看本地 master 分支的状态：

提示本地有修改文件，没有提交。咋整呢？有两种处理方法：

• 啥也无论，直接输入 git pull 进行同步，有冲突会自动合并，合并不了再手动解决。-> 不推荐，可能会在本地产生一条 merge 记录
• 先将本地修改 stash save，再使用 git pull --rebase 进行同步，最后将暂存的修改 stash pop，有冲突会自动合并，合并不了再手动解决。-> 推荐，自动变基，不会在本地产生 merge 记录

1. 暂存代码

git stash save [-u] 'update readme.md'
复制代码

[-u] 表示参数可选，加 -u 会将本地新增文件也暂存，不加则仅暂存本地修改部分。'update readme.md' 为描述，下面列出 git stash 支持的全部操做：

• git stash list 显示全部暂存记录
• git stash show stash@{0} 查看指定的暂存记录
• git stash pop stash@{0} 弹出指定的暂存记录
• git stash drop stash@{0} 删除指定的暂存记录
• git stash clear 清空暂存记录

2. 同步代码

git pull --rebase
复制代码

同步结果：

提示已是最新的。若是本地代码不是最新的，应当相似于下图：

3. 弹出暂存代码

git stash pop [stash@{0}]
复制代码

[stash@{0}] 表示可选，不加默认弹出栈顶元素，也能够指定弹出哪个暂存记录。弹出结果以下：

提示有冲突。莫要惊慌，有冲突解决就是了，毕竟我们干的都是“小项目”，除非文件换行符变了，不然不会冲突太多。像 AOSP、Mokee 那种大型项目，发生冲突才是坑爹。好比国内的手机厂商，每次大版本升级时（好比从 Android 8.0 升到 Android 9.0），都须要花几个月的时间才能使版本稳定，这也是为何国产手机安卓版本老是落后于 Google 的缘由。扯远了，仍是先 git status 看一下工做区状态：

原来是 README.md 文件修改冲突了，并且 Git 还贴心地提示你：

• 使用 git reset HEAD <file> 来丢弃本地修改
• 使用 git add <file>... 标记冲突解决（省略号表示后面可接多个文件，以空格分隔）

咱们先使用 git diff <file> 看看哪里冲突了：

git 使用：

<<<<<<< Updated upstream

=======
>>>>>>> Stashed changes
复制代码

标记冲突状态，======= 上面的是远程仓库上别人的修改，下面的是咱们的本地修改。嗯，这个冲突是我人为制做的，因此比较简单。在 IDE 中手动解决该冲突后，使用 git add README.md 命令标记冲突已解决：

README.md 咋变原谅色了呢？由于咱们刚才用了 git add 命令，将其添加到了暂存区，因此上面显示的是 Changes to be committed，也就是待提交。提交啥啊，刚解决完冲突，需求还没作呢！因此，咱们使用 git reset <file>... 命令，将其从暂存区撤出：

<file>... 表示可选，不加即撤出全部，加了即撤出指定的文件。Linux 帮助手册中不少使用 <arg> 或者 [arg] 表示参数可选，<> 和 [] 是不须要输入的，这个已经成为开发人员的习惯用法。

4. 新建本地分支

不少人这个时候，就直接在本地 master 分支上疯狂输出需求代码了。NO！咱们应该针对不一样的开发内容，新建不一样的本地分支。好比 feature_shopping，bugfix_tombstone 等等，假设咱们如今须要实现一个购物功能，咱们应该使用 git checkout -b feature_shopping 新建一个本地分支来实现这个需求：

5. 提交代码

连续通宵5天后，咱们的需求终于作完了，能够提交代码了：

git commit -m "update README.md" 表示将修改提交到本地仓库，此时尚未推送到远程仓库。-m 后面的是修改描述，这是一种简便写法。而大公司都会对提交的描述有格式要求，因此须要先配置 commit 模板：

git config --global commit.template ~/.gitmsg
复制代码

编辑该模板：

输入 git commit：

模板已经生效了，输入修改描述便可。我这里配置的 Git 编辑器是 vim，你也能够配置成别的：

git config --global core.editor notepad
复制代码

这样，就能够用记事原本编写修改描述了。

6. 追加提交

commit 以后，本地又修改了一些文件，此时须要使用 git commit --amend 追加提交：

7. 回退提交

commit 以后，发现提交多了，把不须要提交的也提交了，此时须要回退，有两种方式：

• git reset [--soft] commit_id，软回退，不会丢弃文件修改记录，--soft 不加也能够。
• git reset --hard commit_id，硬回退，丢弃全部修改。通常仅在须要回退到指定节点验证问题时使用。

查看 commit_id：

git log -1
复制代码

-1 表示只查看提交记录里的最后一条：

输入 git reset 306c8b26360adfbdb3992f62514e8d58626f2d20，便可回退提交。而后从新 git add <file>...，git commit。

8. 推送代码

commit 以后不少人就直接 git push 了，这是不对的，应当先同步代码。因为咱们如今在新建的本地分支 feature_shopping 上，这个分支没有关联远程分支，因此没法也不该该使用 git pull --rebase 来同步代码。正确的操做为：

1. git checkout master：切到本地主分支
2. git pull --rebase：同步代码
3. git checkout feature_shopping：切换到本地需求分支
4. git rebase master：将本地主分支代码，合入到本地需求分支（可能有冲突，按照 Git 的提示修复便可）
5. git push origin HEAD:refs/for/master：将本地需求分支的提交推送到远程 master 分支

结语

Git Bash 每个命令的操做结果，成功或者出错的描述都很详细。遇到问题的时候，只要按照提示，一步步操做，通常都能解决。