版本控制系统(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