Git 是一个免费且开源的版本控制系统，是目前最为流行的 源代码管理 工具，本篇文章从 Git 的基本指令到进阶操作，包含了使用 Git 的过程中遇到的大部分大小问题
基本操作
初始化设置
设置用户名和邮箱
- $ git config --global user.name "用户名"
- $ git config --global user.email "邮箱"
- - 其中，--global 是全局设置，如果想对特定项目使用不同配置，可取消该参数
- - git config 还可以设置其他选项，因为平时不怎么用，所以详细可以参考 git config --help
查看配置
- $ git config --list
- # 查看 Git 的某一项配置
- $ git config user.name
创建 SSH Key
- $ ssh-keygen -t rsa -C "邮箱"
- # 然后会在用户主目录下，发现 .ssh 目录，其中包含 id_rsa 和 id_rsa.pub 两个文件
- # id_rsa.pub 是 SSH Key 公钥，将其添加到 github 的 SSH keys 中，就可以将本地仓库推送到远程仓库了
创建本地仓库，进行基本源代码管理
- # 初始化仓库
- $ git init
- # 将源代码提交到暂存区
- $ git add .
- # 提交暂存区的源代码
- $ git commit -m "本次提交说明"
- # 查看当前状态
- $ git status
- $ git status -sb // 查看 branch 和 short status
- # 查看提交历史
- $ git log
将本地代码同步至远程仓库
- # 克隆
- $ git clone 仓库地址
- # 远程仓库
- $ git remote
- # 分支
- $ git branch 分支名 // 创建
- $ git checkout 分支名 // 切换
- # 合并
- $ git merge 分支名
- # 拉取更新
- $ git fetch 主机名 分支名 // 不合并
- $ git pull 主机名 分支名 // 合并
- # 推送
- $ git push 主机名 分支名
- # 打标签
- $ git tag -a 版本号 -m "版本说明"
进阶操作
忽略 SSL 证书错误
通过 HTTPS 访问 Git 远程仓库时，如果服务器的 SSL 证书未经过第三方机构签署，那么 Git 就会阻止这一操作
- $ env GIT_SSL_NO_VERIFY=true git clone 仓库地址
- $ cd 仓库名称
- $ git config http.sslVerify "false"
- - 使用 env 命令保证了忽略证书错误只应用于此次克隆
储藏
当有未提交的修改，执行 切换分支 或 拉取更新 需要仓库状态保持 clean 的一些操作时，可以使用 git stash 将目前的修改临时储藏起来
- # 储藏
- $ git stash
- # 查看储藏
- $ git stash list
- # 应用最近储藏并删除
- $ git stash pop
- # 应用指定储藏不删除
- $ git stash apply [储藏名]
- # 移除储藏
- $ git stash drop 储藏名
撤消操作
对于 工作区 和 暂存区 的修改，我们不能保证上次操作是完美的，git 就是这么强大，提供了很多 反悔 的操作
- # 丢弃暂存区的文件，放回工作区
- $ git reset HEAD 文件
- # 丢弃工作区的修改
- $ git checkout -- 文件
- - 修改后没添加到暂存区，则撤销到 git commit 时的状态
- - 修改后添加到暂存区，则撤销到 git add 时的状态
- # 覆盖上次提交
- $ git commit --amend [-m "本次提交说明"]
版本回退
- # 回退到之前的某次提交
- $ git reset --hard commit_id
- - HEAD 指向当前版本
- - git log 可以查看提交历史，以便确定要回退到哪个版本
- - git reflog 可以查看命令历史，以便确定要回到未来的哪个版本
- # 撤销一个已经提交
- $ git revert commit_id
- - 并没有从项目历史中移除这个 commit, 而是生成一个新的 commit
分支
Git 有很多优点，其中 分支使用方便 就是很显著的一条，创建仓库的时候，master 是默认的分支，一般，我们会创建其他的分支在上面进行开发，完后再将它们合并到主分支上来
- # 创建开发分支
- $ git branch dev
- # 创建并切换到开发分支
- $ git checkout -b dev
- # 切换回主分支
- $ git checkout master
- # 快速检出上一个分支
- $ git checkout -
- # 查看所有分支
- $ git branch -a
- # 查看合并到当前分支的分支列表
- $ git branch --merged
- # 查看还没合并到当前分支的分支列表
- $ git branch --no-merged
- # 删掉临时分支
- $ git branch -d fix
- # 将开发分支推送到远程仓库
- $ git push origin dev
- # 重命名分支
- $ git branch -m dev develop
- # 删除远程分支
- - $ git push origin --delete 分支名
- - $ git push origin :分支名
标签
软件要发布一个新的版本的时候，我们通常给它打个 tag
- # 打标签
- $ git tag [-a] 标签名 [-m 附注信息 某次提交的id]
- # 推送标签到远程仓库
- $ git push origin 标签名
- $ git push origin --tags // 推送所有标签
- # 删除本地标签
- $ git tag -d 标签名
- # 删除远程标签
- $ git push origin --delete 标签名
- $ git push origin :refs/tags/标签名
提交
- # 花式查看提交
- $ git log --pretty=oneline // 只显示一行
- $ git log --abbrev-commit // 只显示 SHA-1 的前几个字符
- $ git log --graph // 显示 ASCII 图形表示的分支合并历史
- $ git log --relative-date // 使用较短的相对时间显示
- $ git log --name-only // 仅在提交信息后显示已修改的文件清单
- $ git log -n // 显示最近的 n 条提交
- $ git log --author=fengshangwuqi // 仅显示指定作者相关的提交
- $ git log --grep // 仅显示含指定关键字的提交
- # 没有任何改动的提交
- git commit -m "a no chnage commit" --allow-empty
- 主要用于一下情形：
- - 标记新的工作或一个新功能的开始
- - 记录对项目的跟代码无关的改动
- - 跟使用你仓库的其他人交流
- - 作为仓库的第一次提交，因为第一次提交后不能被 rebase
git pull 与 git pull --rebase 的区别
- $ git pull = git fetch + git merge
- $ git pull --rebase = git fetch + git rebase
git merge 与 git rebase 的区别
- # 相同点
- 整合的最终结果所指向的快照是一样的
- # 不同点
- ## 提交历史不同
- - merge 会生成一个新的 commit 节点，提交历史忠实地记录了实际发生过什么
- - rebase 不会产生额外的 commit 节点，提交历史反映了项目过程中发生了什么
- ## 冲突处理策略不同
- - merge 遇见冲突后会直接停止，等待手动解决冲突并重新提交后，才能再次 merge
- - rebase 遇见冲突后会暂停当前操作，开发者可以选择手动解决冲突，然后 git rebase --continue 继续，或 --skip 跳过，或 --abort 停止
- # 注意事项
- ## 推荐 git merge 结合 --no-ff 一起使用
- - git merge 默认是 fast forward（快速合并），适用于分支 B 从分支 A 从 checkout 出来后，分支 A 没有 commit
- - 如果分支 B 被 checkout 出来后，分支 A 也有修改，那么就没法快速前进合并，会额外建立一个 merge commit，对分支 A 和分支 B 做一个合并操作，即 --no-ff，它的好处是保持了分支的结构
其他
忽略特殊文件
对于 操作系统自动生成 的文件，编译生成 的中间文件，以及带有 敏感信息 的配置文件等，我们不想追踪，也不想放进我们的远程仓库中，这时，我们创建一个 .gitignore 文件来忽略上述文件，下面是一个前端工程忽略的文件参考
- # Logs
- logs
- *.log
- # Runtime data
- pids
- *.pid
- *.seed
- *.DS_Store
- # testing
- coverage
- # Dependency directory
- node_modules
- # Bower
- bower_components/
- dist
- # WebStorm文件
- *.idea/
- # vscode文件
- .vscode/
- # Emacs
- .tern-port
- .#*
- *#
- *~
- # vim
- .agignore
- # 敏感信息
- default.yml
Commit message 指南
好的 Commit message 可以提供更多的历史信息，方便 快速浏览和查找，还可以直接生成 Change log，一般至少包含 type 和 subject，type 是 commit 的类别，subject 是 commit 的简短描述
- ## type
- - feat：添加新功能
- - fix：修补缺陷
- - docs：修改文档
- - style：修改格式
- - refactor：重构
- - perf：优化
- - test：增加测试
- - chore：构建过程或辅助工具的变动
- - revert：回滚到上一个版本
除此之外，有兴趣的同学还可以添加 gitmoji 和 validate-commit-msg 等更多内容
使用 Commit 信息关闭 Issue
如果某个提交修复了一个 Issue，当提交到某个分支时，提交信息里可以使用 fix/fixes/fixed, close/closes/closed 或者 resolve/resolves/resolved 等关键词，后面再跟上 Issue 号，这样就会关闭这个 Issue
- $ git commit -m "fix: ..., fix #1, #2"
这将会关闭 Issue #1 和 #2，并且在 Issue 讨论列表里关联引用这次提交
如果想链接 其他仓库的 Issue，则使用 {user}/{repo}#ISSUE_NUMBER
快速添加许可证文件
在创建一个仓库时，Github 会为你提供一个预置的软件许可证列表
如果此时没有选择，后来可以通过 web 界面 create new file，输入 LICENSE，点击右侧的 choose a license template 来添加
一些不错的 github 插件
- Octotree：提供项目目录
- GitHub Plus：提供每个文件的大小和下载链接
- GitHub Hovercard：悬停在用户头像或仓库地址上时，通过悬浮框提供更多信息
- Sourcegraph for GitHub：提供 IDE 上常用的功能操作
- Awesome Autocomplete for GitHub：提供更强大的智能搜索
- Isometric Contributions：更友好地展示提交记录
Git.io
Git.io 是 Github 的 短网址 服务
你可以通过 Curl 命令以普通 HTTP 协议使用它
- $ curl -i https://git.io -F "url=https://github.com/..."
- HTTP/1.1 201 Created
- Location: https://git.io/abc123
- $ curl -i https://git.io/abc123
- HTTP/1.1 302 Found
- Location: https://github.com/...
Gists
Gists 方便我们管理代码片段，不必使用功能齐全的仓库
Gist 可以非常方便地得到便于嵌入到其他网站的 HTML 代码
而且，Gists 可以像任何标准仓库一样被克隆，你可以像 Github 仓库一样去修改和更新 Gists，只不过，Gists 不支持目录，所有文件都添加在仓库的根目录下
使用快捷键
github 仓库页面 提供了一些 快捷键 方便大家快速导航，按 ? 可以查看当前页面支持的 快捷键列表
使用表情符
我们在 Pull Requests, Issues, commit, Markdown 文件中可以加我们喜欢的表情，使用方法如下
- :name_of_emoji:
比如 :joy: 会返回一个
更多表情，可参考 emoji-cheat-sheet
其中，可能常用的表情有
- :tada:
- :sparkles:
- :bug::
- :white_check_mark::
- :wrench:
- :ok_hand:
- :construction_worker:
- :whale:
- :clap:
