git 常用API

# 概述
提供一份鸟瞰图：
![git api](https://user-images.githubusercontent.com/8131019/44184858-9f29d600-a143-11e8-9b02-65806152789d.png)


## 1. 初次配置
#### 1. 账户信息

```bash
git config --global user.name ""
git config --global user.email ""
```

#### 2. 凭证存储

```bash
git config  credential.helper store //(当前仓库)
git config --global credential.helper store //（全局仓库，与上方可以只设置一个或两个都设置，push 时会优先第一个，如果第一个没有，会再去找全局配置）
```

credential.helper：
1. 默认所有都不缓存。
2. “cache” 模式会将凭证存放在内存中一段时间。 密码永远不会被存储在磁盘中，并且在15分钟后从内存中清除。
3. “store” 模式会将凭证用明文的形式存放在磁盘中，并且永不过期。 这意味着除非你修改了你在 Git 服务器上的密码，否则你永远不需要再次输入你的凭证信息。 这种方式的缺点是你的密码是用明文的方式存放在你的 home 目录下。

> 注意，如果设置为store后，如果你的git账户信息过期，或者你修改了密码后，将不能从远端拉取或推送代码。因为本地存储了你的账户信息，你需要重新设置credential.helper为空：`git config [--global] credential.helper ""`，就可以手动输入新的账户信息，重新设置为store后又可以免去多次输入账户信息的麻烦。

#### 3. 颜色

```bash
git config --global color.ui auto
```

#### 4. 换行符

```bash
# 提交时转换为LF，检出时转换为CRLF
git config --global core.autocrlf true

# 提交时转换为LF，检出时不转换
git config --global core.autocrlf input

# 提交检出均不转换
git config --global core.autocrlf false
```

> 推荐：在Mac上设置 autocrlf = input, 在Windows上设置autocrlf = true（默认值）。这样即可保证仓库中永远都是LF。而且在Windows工作空间都是CRLF, 在Mac/Linux工作空间都是LF。

#### 5. 查看所有可配置属性

```bash
git config --list
```

上面的指令可以查看所有可以配置的属性，和已经配置的属性值。

#### 6. 忽略文件

可以通过添加`.gitignore`文件来避免纳入 **Git** 的管理范畴。

> .gitignore文件只能作用在Untracked Files，也就是那些从来没有被 Git 记录过的文件（自添加以后，从未 add 及 commit 过的文件）。我们可以通过指令`git rm --cached [file_name]`来删除文件跟踪，但是不删除本地文件。

文件格式：

1. 所有空行或者以 ＃ 开头的行都会被 Git 忽略。
2. 可以使用标准的 glob 模式匹配。
3. 匹配模式可以以（/）开头防止递归。
4. 匹配模式可以以（/）结尾指定目录。
5. 要忽略指定模式以外的文件或目录，可以在模式前加上惊叹号（!）取反。

## 2. 本地操作
#### 1. 初始化git仓库和删除仓库

```bash
git init

rm -rf .git  # Linux
rd /s /q .git  # Windows
```

#### 2. 查看状态和提交历史
1. 查看状态报告

```bash
git status
-s，简览
```

2. 查看文件差异

```bash
查看工作区和暂存区（暂存区不存在则为版本库）的差异，git diff [file-path]
查看暂存区与版本库的差异，git diff --cached [file-path]
查看工作区与指定版本库的差异，git diff <commit-id> [file-path]
查看两个版本库之间的差异，git diff <commit-id> <commit-id> [file-path]
```

3. 查看提交历史

```bash
git log [branch_name]
-p，按补丁格式显示每个更新之间的差异。
--stat，显示每次更新的文件修改统计信息。
--pretty = oneline | format，使用其他格式显示历史提交信息。
--graph，显示 ASCII 图形表示的分支合并历史。
-{number}，仅显示最近的 n 条提交。
```

4. 查看某个commit的内容

```bash
git show [COMMIT]
git diff [COMMIT]^!
```

5. git reflog

> 如果在回退以后又想再次回到之前的版本，git reflog 可以查看所有分支的所有操作记录（包括commit和reset的操作），包括已经被删除的commit记录，git log则不能察看已经删除了的commit记录。

#### 3. 状态变更操作
1. 跟踪文件

```bash
git add {file}，把文件当前状态放入暂存区域
git add . ，提交新文件(new)和被修改(modified)文件，不包括被删除(deleted)文件
git add -u（--update），提交被修改(modified)和被删除(deleted)文件，不包括新文件(new)
git add -A（--all），提交所有变化
```

2. 提交更新

```bash
git commit
-m {comment}，备注信息
-a，自动把所有已经跟踪过的文件暂存起来一并提交，从而跳过 git add 步骤
-n --no-verify，绕过pre-coomit和commit-msg钩子
```

3. 记录移除文件的操作，并连带从工作目录中删除指定的文件

```bash
git rm {file}
-f， 如果删除之前修改过并且已经放到暂存区域的话，则必须要用强制删除选项 -f。
--cached，想把文件从 Git 仓库中删除（亦即从暂存区域移除），但仍然希望保留在当前工作目录中。
```
4. 移动文件

```bash
git mv {file_from} {file_to}

git mv 相当于下面三个操作：
$ mv {file_from} {file_to}
$ git rm {file_from}
$ git add {file_to}
```

#### 4. 分支操作

1. 新建分支、删除分支

```bash
git branch {branch_name}

git branch -d {branch_name}，如果包含还未合并的工作，将会失败
git branch -D {branch_name}，强制删除
```

2. 切换分支

```bash
git checkout {branch_name}，切换分支

git checkout -b {branch_name} [{remote_name}/{remote_branch}]，创建并切换分支，还可以指定远程分支

git checkout -，切换到上一个分支
```

3. 合并分支

```bash
git merge <branch>，合并分支
--no-ff，不使用fast-forward方式合并，保留分支的commit历史
--squash，使用squash方式合并，把多次分支commit历史压缩为一次
```

4. 分支存档

```bash
git stash，存储工作目录和索引（暂存区域）的当前状态，并返回干净的工作目录
git stash save "comments"，为stash添加备注
git stash pop，还原最近一次存储
git stash drop {stash_name}，删除指定的stash
git stash list，查看存储列表
git stash show [-p] {stash_name}，查看指定的stash的diff
git stash apply {stash_index}，根据index还原存储
```

> git stash会缓存下列文件：添加到暂存区的修改（staged changes）；Git跟踪的但并未添加到暂存区的修改（unstaged changes）。

> 但不会缓存以下文件：在工作目录中新的文件（untracked files）；被忽略的文件（ignored files）。可以通过加参数`-u`或`--include-untracked`缓存新文件。

5. 查看本地分支跟踪的远程分支

```
git branch -vv
```

6. 切换本地分支跟踪的远程分支

```
git branch -u {remote_branch_name} {local_branch_name}
```

#### 5. 版本操作

1. 补充提交遗漏文件

```bash
git commit --amend
```

2. git reset

```bash
git reset --soft {HEAD_pointer} [file_name]，移动 HEAD 分支的指向
git reset --mixed {HEAD_pointer} [file_name]，默认，使索引（暂存区域）看起来像 HEAD
git reset --hard {HEAD_pointer} [file_name]，使工作目录和索引（暂存区域）看起来像 HEAD
```

> 说以下使用--soft的场景，假设你从特定版本（v1）开始修改代码，修改到了版本（v2），想要查看整个过程都修改了哪些文件的话，使用--soft把HEAD指向版本（v1），就可以看到整个过程修改的文件。

3. git revert

```bash
git revert {HEAD_pointer}，用一次新的commit来回滚之前的commit
```

4. 合并快照

```bash
git rebase -i {startpoint}  [endpoint]，合并startpoint到endpoint区间的提交操作
```

## 3. 远程操作

1. 拷贝远程仓库

```bash
git clone {remote_url} [local_url]
```

2. 添加远程仓库

```bash
git remote add {remote_name} {remote_url} # 添加一个新的远程仓库引用到当前的项目

git remote [-v] # 列出所有远程主机
git remote rm {remote_name} # 删除远程主机
git remote rename {remote_name} {new_remote_name} # 重命名远程主机
```

3. 拉取

```bash
git fetch {remote_name} [branch_name] # 拉取远程主机更新，也可以指定某一分支

git pull {remote_name} {remote_branch_name}:{local_branch_name} # 拉取远程主机更新，再与本地指定的分支合并，如果是当前分支的话，:{local_branch_name}可以省略。
git pull origin master --allow-unrelated-histories，允许合并不相关历史的内容。
```

> git pull = git fetch + git merge

4. 推送

```bash
git push {remote_name} {local_branch_name}:{remote_branch_name} # 推送本地分支的更新到远程主机的指定分支。
git push --set-upstream {remote_name} {remote_branch_name} # 设置当前分支的默认远程主机上的分支。
```

> 如果推送的本地分支有跟踪分支，可以省略:{remote_branch_name}
> 如果推送的本地分支就是当前分支，可以省略{local_branch_name}
> 如果当前分支只有一个追踪分支，可以省略{remote_name}

5. 跟踪分支
跟踪分支是与远程分支有直接关系的本地分支。 如果在一个跟踪分支上输入 git pull，Git 能自动地识别去哪个服务器上抓取、合并到哪个分支。git push也是一样的。

> git clone，会默认帮你把master和origin/master建立追踪关系

```bash
git branch -u {remote_branch_name} # 让当前分支和远程分支建立追踪关系
```

> 跟踪分支的设置在git config 里的 `branch.<name>.merge`

# 参考
[Git远程操作详解](http://www.ruanyifeng.com/blog/2014/06/git_remote.html)
[Git 分支 - 远程分支](https://git-scm.com/book/zh/v2/Git-%E5%88%86%E6%94%AF-%E8%BF%9C%E7%A8%8B%E5%88%86%E6%94%AF)
[git中配置autocrlf来正确处理crlf](https://blog.csdn.net/lysc_forever/article/details/42835203)
[git-stash用法小结](https://www.cnblogs.com/tocy/p/git-stash-reference.html)
[git取消文件跟踪](https://www.cnblogs.com/zhuchenglin/p/7128383.html)
[.gitignore模板](https://github.com/github/gitignore)

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

git 常用API #55

概述

1. 初次配置

1. 账户信息

2. 凭证存储

3. 颜色

4. 换行符

5. 查看所有可配置属性

6. 忽略文件

2. 本地操作

1. 初始化git仓库和删除仓库

2. 查看状态和提交历史

3. 状态变更操作

4. 分支操作

5. 版本操作

3. 远程操作

参考

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

git 常用API #55

Description

概述

1. 初次配置

1. 账户信息

2. 凭证存储

3. 颜色

4. 换行符

5. 查看所有可配置属性

6. 忽略文件

2. 本地操作

1. 初始化git仓库和删除仓库

2. 查看状态和提交历史

3. 状态变更操作

4. 分支操作

5. 版本操作

3. 远程操作

参考

Metadata

Metadata

Assignees

Labels

Projects

Milestone

Relationships

Development

Issue actions