Git 笔记

Mon, 07 Jun 2021 00:00:00 +0800

术语 #

工作区（Working Directory）：从某个版本独立提取出来的内容，也包括未被 Git 管理的文件。简单来说就是 .git 文件夹以外的内容。
暂存区（Staging Area）：记录了待提交信息的一个文件。
仓库/版本库（Repository）：Git 用来保存项目的元数据和对象数据库的地方，也就是 .git 文件夹。

配置 #

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19


# 名字和邮箱必须设置，其他按需要配置就好
git config --global user.name "your-name"
git config --global user.email "your-email"

# 设置远程分支后才能用 `git push`
git config --global push.default simple

# 显示中文路径
git config --global core.quotepath false

# 设置编辑器
git config --global core.editor "nano"

# 设置换行符为 LF
git config --global core.autocrlf input

# 设置好看的 git log
git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit"
git config --global alias.lgs "log --pretty=oneline --graph --abbrev-commit"

.gitignore #

.gitignore 用于忽略不需要的文件，例如：

1
2
3
4


node_modules
.DS_Store
.idea
.vscode

命令别名（alias） #

配置命令别名后操作更简单，Oh My Zsh 的 git 插件就自动配置了别名。如果不用 zsh，手动添加别名到 ~/.bashrc 也行。

1
2
3
4
5
6


alias ga='git add'
alias gc='git commit -v'
alias gl='git pull'
alias gp='git push'
alias gco='git checkout'
alias gst='git status'

配置 SSH 密钥 #

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14


# 生成 SSH 密钥（ed25519 比 RSA 安全）
ssh-keygen -t ed25519 -C "注释"

# 查看密钥
cat ~/.ssh/id_ed25519.pub

# 复制代码
xclip -selection clipboard < ~/.ssh/id_ed25519.pub

# 添加密钥到 GitHub
xdg-open https://github.com/settings/ssh/new

# 接收 GitHub 公钥
ssh -T git@github.com

GitHub 文档

创建仓库 #

1
2
3
4
5


# 初始化当前目录
git init

# 初始化文件夹
git init directory-name

分支 #

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20


# 查看分支
git branch

# 创建分支
git branch branch-name

# 切换分支
git switch branch-name
git checkout branch-name

# 创建并切换分支
git switch -c branch-name # -c --create
git checkout -b branch-name # -b(branch)

# 删除分支
git branch -d branch-name

# 合并分支
git checkout main # 切换到接受代码的分支
git merge patch # 把 patch 分支的代码合并到 main

远程仓库 #

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24


# 克隆仓库
git clone repo-link
git clone repo-link local-repo-name # 克隆并重命名
git clone repo-link . # 克隆到当前文件夹（不推荐）
gh repo clone username/repo-name

# 添加远程仓库
git remote add remote-name repo-link

# 查看远程仓库
git remote -v

# 删除远程仓库
git remote remove remote-name

# 推送代码
git push remote-name local-branch:remote-branch
git push -u remote-name branch-name # 设置上游
git push remote-name branch-name
git push

# 拉取代码
git pull remote-name branch-name
git pull

查看状态 #

1
2
3
4
5


# 详细内容
git status

# 精简内容
git status -sb 

把文件加到暂存区 #

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11


# 添加文件
git add file-name
git add file-1 file-2

# 添加目录
git add directory-name

# 添加所有文件
git add .
git add *
git add --all

恢复暂存区的文件 #

1
2
3
4
5


# 恢复所有
git reset -- .

# 恢复某个文件或目录
git reset -- file-name

隐藏未提交的内容 #

1
2
3
4
5
6
7
8


# 隐藏暂存区
git stash

# 查看隐藏内容
git stash list

# 恢复内容
git stash pop

清空暂存区 #

1

git clean -di

删除文件 #

以下方法删除的内容仍然可以被恢复。如果要完全删除，请参考完全删除 Git 仓库的文件。

1
2
3
4
5
6


# 方法 1（推荐）
git rm file-name

# 方法 2
rm file-name
git add file-name

提交代码 #

1
2


git commit -v # 在提交说明底部显示 diff
git commit -m "提交说明" # 不推荐

查看历史 #

1
2
3
4
5
6
7


# 查看历史
git log
git log --pretty=oneline --graph --abbrev-commit
git log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit

# 查看所有历史（git reset 之前的都有）
git reflog # reflog 只在本地，不会上传到远程仓库

版本回退 #

1
2
3


# --hard 会删除暂存区的文件
git reset --hard commit-id
git reset --hard HEAD

解决冲突 #

git status 查看冲突文件
打开冲突文件
搜索 =======
删除冲突文件里的 <<<<<<< HEAD、=======、>>>>>>> branch-name
修改文件，留下需要的代码
git add conflicted-file
解决完所有冲突再运行 git commit

合并提交 #

1
2
3
4
5
6
7
8
9


# 合并提交
git rebase -i HEAD~3
git rebase -i commit-id

# 取消 rebase
git rebase --abort

# 继续 rebase
git rebase --continue

完全删除 Git 仓库的文件

Mon, 25 Jan 2021 00:00:00 +0800

步骤 #

完全删除 Git 仓库的文件是我不常用的操作，但好像每年都得用几次。还是把方法摘抄于此作为备忘录，省得下次再去搜索。这个方法是从 GitHub 文档抄来的，操作比较危险，请先把本文看完再尝试。可以把整个仓库复制到另一个地方来尝试前 2 步。

重写历史
1 2 3

git filter-branch --force --index-filter \ "git rm --cached --ignore-unmatch path/to/your/file" \ --prune-empty --tag-name-filter cat -- --all
注意，此命令需要在仓库根目录运行。如果反悔了就用 git reflog 查看第 2 条历史的哈希值，然后用 git reset --hard commit-id 就可以恢复了。

清除 reflog

1
2
3


git for-each-ref --format="delete %(refname)" refs/original | git update-ref --stdin
git reflog expire --expire=now --all
git gc --prune=now

执行了这些命令之后文件就真的消失了，无法恢复。

推送更改到远程仓库

1
2


git push origin --force --all
git push origin --force --tags

联系 GitHub 删除 pull requests 中的文件

上述操作十分危险，如非必要，千万别在公开的仓库使用，不然会给开发者带来麻烦。使用后 Git 历史会被重写，别人 git pull 时会出错。

技巧 #

下面这几条技巧可以帮你避免添加不必要的文件。

用 .gitignore 排除文件
使用 GUI 软件，用 GUI 更容易看出具体的文件变动
使用 git add filename 和 git rm filename 来代替 git add . 和 git commit -a
使用 git add --interactive 添加文件
使用 git diff --cached 查看变动

Git on 叶寻的博客