版本控制系统（VCS）是管理文件和目录所做的更改的工具，每一次提交便记录下目录及其文件的内容，以及较上一版本的更改。通过这样去跟踪项目的更改过程，方便与他人进行协作，或者撤销不想要的更改以回退到此前的任一个版本。常见的有Git、SVN、CVS、RCS等，其中最常用的便是Git。
一、关键术语
- 本地储存库（local repository）：包含项目文件的本地目录
- 远程储存库（remote repository）：托管在服务器（如 GitHub、GitLab、BitBucket）上的项目文件目录
- 克隆（clone）：复制储存库到新的路径
- 提交（commit）：每次提交操作产生一个项目的快照
- 分支（branch）：从某个提交开始从主分支中分离出去的一个项目副本
- 合并（merge）：将两个分支合并（一般需要处理文件冲突）
- .gitignore：在提交中选择性忽略的文件（例如过大的数据集、私人信息等）
- 暂存区（staging area）：保留部分更改在下一次提交
- Git stash：类似暂存区，用于缓存可能稍后要撤销的更改
- Commit ID：每个提交的哈希值编码，用于唯一确认
- HEAD：最近提交的代号，避免定位时需要输入一长串的哈希值，可用 HEAD~n 表示最近的第 n 次提交
二、初始设置
设置用户信息，团队协作时用来确定更改人，以便于沟通。
git config --local user.email useremail@domain.com
git config --local user.name username
指定设置的范围：
- 只在当前项目目录有效（默认）：
--local - 对于当前系统用户的所有项目有效：
--global - 对于当前机器的所有用户的所有项目有效：
--system
列出所有设置值：
git config --list
查看某个设置值：
git config --get <key>
为常用操作设置别名：
git config --global alias.ga add
git config --global alias.gc commit
ga filename
gc -m "commit description"
三、基本操作
从远程服务器复制储存库
git clone <remote-repo-url>
git clone -branch <branch_name> <repo-url> # 指定复制的分支
git clone <repo_url> <dir_name> # 复制到指定的路径
两种克隆方式：HTTP 链接和 SSH 链接
git clone https://github.com/username/reponame.git
git clone git@github.com:username/reponame.git
在本地目录新建储存库
git init
git init [directory]
管理远程储存库
git remote # 列出远程储存库
git remote add <connection_name> <url_to_remote> # 链接远程储存库
git remote rm <connection_name> # 删除链接
git remote rename <connection_name> <new_name> # 重命名链接
四、文件操作
添加文件到暂存区以及从暂存区移除文件
git add <filename_or_directory>
git rm <filename_or_directory>
git add . # 接受正则，“.”代表添加全部
更改操作（先执行上面的添加操作，再执行更改提交）
git status # 显示更改情况，包括已暂存未提交或已更改未暂存
git diff # 更加详细版本的 git status，包含具体更改内容
git diff <id1> <id2> # 比较任意两个提交版本
git commit -m "commit description" # 提交暂存区的更改
git commit -am "commit description" # 提交所有的更改，包括未暂存的
git commit --amend -m "new description" # 重新编辑最近的提交的描述信息
贮藏操作（临时保存工作副本以便稍后返回，而不需要提交）
git stash # 储存更改
git stash -U # 较上，包括未跟踪的文件
git stash --all # 较上，包括所有文件，甚至 ignored 的文件
git stash pop # 应用此前的储存，并清除储存区
git stash apply # 应用但不清除
git stash drop # 删除但不应用
撤销更改（检查提交，并在有需要时撤销之前的提交）
git checkout HEAD~2 # 切换到最近的第二个提交版本
git checkout <commit_id> # 按 id 切换到某一个提交版本
git reset HEAD~1 # 撤销提交，但不会改变工作目录的文件
git reset --hard <commit_id> # 回到该版本，文件也跟着改变
git revert <commit_id> # 只撤销该次提交包含的更改，而 reset 会撤销该提交以及此后的所有更改
五、仓库操作
（1）分支
如下图，常规操作为，在主分支的基础上，创建新的分支，此时新分支为主分支的副本，内容一致。接下来在新分支进行新的工作（例如为程序加入新的功能），同时主分支可以继续原来的工作（如完善原有的功能），最后处理文件冲突并合二为一。按照同样的原理可以创建多个分支，并根据需要在不同的分支之间进行合并。
git branch --list # 列出所有分支
git branch -a # 列出所有分支，包括远程储存库中的
git branch <new_branch_name> # 创建新的分支
git checkout <branch_name> # 切换到某个分支
git checkout -b <new_branch_name> # 创建新分支并切换到新分支
git branch -d <branch_name> # 安全删除分支，避免删除未合并的更改
git branch -D <branch_name> # 忽视更改强行删除
git branch -m <new_name> # 重命名
git push <remote_repo> branch~ # 上传分支到远程储存库
git push <remote_repo> --delete <branch_name> # 从远程储存库中删除分支
git diff <branch1> <branch2> # 对比两个分支
git diff <branch1> <branch2> # 对比两个分支中的某个文件
# 切换到主分支并合并
git checkout main
git merge <other_branch>
（2）其他
git fetch # 同步 .git 文件夹，但不改变项目中的文件
git merge # 合并远程和本地（会更改文件）
git pull # 同步并合并（会更改文件）
git log # 查看提交历史
git log --stat # 详细版，包括文件更改细节
git log --after="YYYY-MM-DD" --before="yesterday" # 按时间列出
# 还可以使用 last month、last year 之类的关键词
END
