0. Git简介
git是一个分布式版本控制软件,最初由林纳斯·托瓦兹(Linus Torvalds)创作,于2005年以GPL发布。最初目的是为更好地管理Linux内核开发而设计。Git可以在任何时间点,把文档的状态作为更新记录保存起来。因此可以把编辑过的文档复原到以前的状态,也可以显示编辑前后的内容差异。
而且,编辑旧文件后,试图覆盖较新的文件的时候(即上传文件到服务器时),系统会发出警告,因此可以避免在无意中覆盖了他人的编辑内容。
更多内容请查看Git维基百科。
1. Git Vs SVN
分布式 vs 集中管理 (多份版本库 vs 一份版本库,设想下版本服务器挂了?)
无需网络,随时随地进行版本控制,在没有网络的情况下你想回退到某个版本svn基本没戏;
分支的新建、合并非常方便、快速,没有任何成本,基本不耗时,svn的版本基本上等同于又复制了一份代码。
stackoverflow 上关于svn和git的区别的讨论,说的很详细,请参考 Why is Git better than Subversion?
Github上通过版本库结构、历史、子项目(submudle)的不同来对比两者,请参考Github的 What are the differences between SVN and Git?
2.安装
通过官网安装。
下面推荐各个OS的GUI( 图形用户界面)Git工具,但还是强烈推荐使用命令行操作Git。
Windows
乌龟Tortoisegit
https://tortoisegit.org/Mac
免费的SourceTree客户端。
http://www.sourcetreeapp.com/Linux
不推荐客户端,可以使用发行版包含的基础软件包管理工具来安装。 如果以 Fedora 上为例,你可以使用 yum:
$ sudo yum install git
如果你在基于 Debian 的发行版上,请尝试用 apt-get:
$ sudo apt-get install git
3. 配置
Git 自带一个 git config 的工具来帮助设置控制 Git 外观和行为的配置变量。 这些变量存储在三个不同的位置:
/etc/gitconfig
文件: 包含系统上每一个用户及他们仓库的通用配置。 如果使用带有--system
选项的git config
时,它会从此文件读写配置变量。~/.gitconfig
或~/.config/git/config
文件:只针对当前用户。 可以传递--global
选项让 Git 读写此文件。当前使用仓库的 Git 目录中的 config 文件(就是
.git/config
):针对该仓库。
每一个级别覆盖上一级别的配置,所以 .git/config 的配置变量会覆盖 /etc/gitconfig 中的配置变量。
在 Windows 系统中,Git 会查找 $HOME 目录下(一般情况下是 C:\Users\$USER
)的 .gitconfig 文件。 Git 同样也会寻找 /etc/gitconfig
文件,但只限于 MSys 的根目录下,即安装 Git 时所选的目标位置。
3.1 用户信息配置
每一个 Git 的提交都会使用这些信息,并且它会写入到你的每一次提交中,不可更改:
$ git config --global user.name "mantoudev"
$ git config --global user.email mantoudev@163.com
如果使用了 --global 选项,那么该命令只需要运行一次,因为之后无论你在该系统上做任何事情, Git 都会使用那些信息。 当你想针对特定项目使用不同的用户名称与邮件地址时,可以在那个项目目录下运行没有 --global 选项的命令来配置。
很多 GUI 工具都会在第一次运行时帮助你配置这些信息。
3.2 检查配置信息
如果想要检查你的配置,可以使用 git config --list
命令来列出所有 Git 当时能找到的配置。
$ git config --list
user.name=mantoudev
user.email=mantoudev@163.com
color.status=auto
color.branch=auto
color.interactive=auto
color.diff=auto
...
你可能会看到重复的变量名,因为 Git 会从不同的文件中读取同一个配置(例如:/etc/gitconfig 与 ~/.gitconfig
)。 这种情况下,Git 会使用它找到的每一个变量的最后一个配置。
你可以通过输入 git config <key>:
来检查 Git 的某一项配置
$ git config user.name
mantoudev
4. 基本常用命令
4.1 添加文件到暂存区(staged)
$ git add filename
#或
$ git stage filename
4.2 将所有修改文件添加到暂存区(staged)
$ git add --all
#或
$ git add -A
4.3 提交修改到暂存区(staged)
$ git commit -m 'commit message'
$ git commit -a -m 'commit message'
注意理解 -a 参数的意义
4.4 从Git仓库中删除文件:
$ git rm filename
4.5 从Git仓库中删除文件,但本地文件保留:
$ git rm --cached filename
4.6 重命名某个文件:
$ git mv filename newfilename
#或者直接修改完毕文件名 ,进行
$ git add -A && git commit -m 'commit message'
Git会自动识别是重命名了文件
4.7 获取远程最新代码到本地:
$ git pull (origin branchname)
可以指定分支名,也可以忽略。pull 命令自动 fetch 远程代码并且 merge,如果有冲突,会显示在状态栏,需要手动处理。更推荐使用:git fetch
之后 git merge --no-ff origin branchname
拉取最新的代码到本地仓库,并手动 merge 。
5. Git commit messge规范
查看Commit message
$ git log <last tag> HEAD --pretty=format:%s
5.0 Commit Message格式
每次提交,Commit message 都包括三个部分:Header,Body 和 Footer。
<type>(<scope>): <subject>
// 空一行
<body>
// 空一行
<footer>
其中,Header 是必需的,Body 和 Footer 可以省略。
不管是哪一个部分,任何一行都不得超过72个字符(或100个字符)。
5.1 Header
Header部分只有一行,包括三个字段:type(必需)、scope(可选)和subject(必需)。
(1)type
type
用于说明 commit 的类别,只允许使用下面7个标识。
- feat:新功能(feature)
- fix:修补bug
- docs:文档(documentation)
- style: 格式(不影响代码运行的变动)
- refactor:重构(即不是新增功能,也不是修改bug的代码变动)
- test:增加测试
- chore:构建过程或辅助工具的变动
- revert: 撤销以前的 commit,后面跟着被撤销 Commit 的 Header。
(2)scope
scope
用于说明 commit 影响的范围,比如数据层、控制层、视图层等等,视项目不同而不同。
(3)subject
subject是 commit 目的的简短描述,不超过50个字符。
- 以动词开头,使用第一人称现在时,比如change,而不是changed或changes
- 第一个字母小写
- 结尾不加句号(.)
5.2 Body
Body 部分是对本次 commit 的详细描述,可以分成多行。下面是一个范例。
此次修改主要对****功能模块进行重构,包含以下部分:
1. AAAAAAA....
2. BBBBBBB....
3. CCCCCCC....
body中还可以与一些Bug管理工具进行关联,在Header之后换行添加
Bug: <Bug编号>
5.4 Footer
(1)不兼容变动
如果当前代码与上一个版本不兼容,则 Footer 部分以BREAKING CHANGE
开头,后面是对变动的描述、以及变动理由和迁移方法。
BREAKING CHANGE: isolate scope bindings definition has changed.
To migrate the code follow the example below:
Before:
scope: {
myAttr: 'attribute',
}
After:
scope: {
myAttr: '@',
}
The removed `inject` wasn't generaly useful for directives
(2) 关闭 Issue
如果当前 commit 针对某个issue,那么可以在 Footer 部分关闭这个 issue 。
Closes #234
(3) 签名
如果commit使用签名的话,footer中会包含签名信息
Signed-off-by: mantoudev <mantoudev@163.com>
(4) 其他
使用gerrit(代码审查工具,gerrit维基百科),在footer中会生成一个ChanggeId,一个ChangeId标识一次内容变化,可以包含多个commit,即多个commit如果changeid一致的话,可以认为是一个change。