术语
- 工作区（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 [email protected]
|
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
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
|
解决冲突
合并提交
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
|