Git 常用操作总结

版本控制系统（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 [email protected]
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 [email protected]: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