Git 快速入门
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. 基本常用命令
(1) 添加文件到暂存区(staged)
$ git add filename
#或
$ git stage filename
(2) 将所有修改文件添加到暂存区(staged)
$ git add --all
#或
$ git add -A
(3) 提交修改到暂存区(staged)
$ git commit -m 'commit message'
$ git commit -a -m 'commit message'
注意理解 -a 参数的意义
(4) 从Git仓库中删除文件:
$ git rm filename
(5) 从Git仓库中删除文件,但本地文件保留:
$ git rm --cached filename
(6) 重命名某个文件:
$ git mv filename newfilename
#或者直接修改完毕文件名 ,进行
$ git add -A && git commit -m 'commit message'
Git会自动识别是重命名了文件
(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.1 Commit Message格式
每次提交,Commit message 都包括三个部分:Header,Body 和 Footer。
<type>(<scope>): <subject>
// 空一行
<body>
// 空一行
<footer>
其中,Header 是必需的,Body 和 Footer 可以省略。
不管是哪一个部分,任何一行都不得超过72个字符(或100个字符)。
5.2 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.3 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。
6. 乱码处理
Linux 、MacOS默认编码为utf-8,windows默认编码为GBK。提交时编码不统一,或者展示时编码不统一,会出现乱码的情况。
6.1 git status
时中文文件名乱码
现象:
\344\275\240\345\245\275
执行以下命令即可:
git config --global core.quotepath false
quotepath解释:
The commands that output paths (e.g. ls-files, diff), when not given the -z option,will quote "unusual" characters in the pathname by enclosing the pathname in a double-quote pair and with backslashes the same way strings in C source code are quoted. If this variable is set to false, the bytes higher than 0x80 are not quoted but output as verbatim. Note that double quote, backslash and control characters are always quoted without -z regardless of the setting of this variable.
6.2 git log
查看提交中含中文乱码
现象:
<E4><BF><AE><E6>
- 修改git全局配置设置提交和查看日志编码都是utf-8
git config --global i18n.commitencoding utf-8
git config --global i18n.logoutputencoding utf-8
- 修改git目录下etc\profile文件,设置less的字符集为utf-8
export LESSCHARSET=utf-8
- (Windows)修改cmder目录vendor\init.bat文件,添加以下代码,设定cmder编码为utf-8
@chcp 65001 > nul
chcp 65001的解释:
Why is there no option to choose codepage 65001 (UTF-8) as a default codepage in console window
6.3 gitk查看中文乱码
解决办法:
git config --global gui.encoding utf-8