git操作命令大全

1. 配置

# 检查配置信息
$ git config --list
# 查看全局配置列表
$ git config --global -l
# 查看局部配置列表
$ git config --local -l

# 查看所有的配置以及它们所在的文件
$ git config --list --show-origin

# 修改本地默认分支 master变为main
$ git config --global init.defaultBranch main

# 设置全局用户名/邮箱
$ git config --global user.name "姓名"
$ git config --global user.email "你的邮箱地址"

# 设置当前工作区仓库用户名/邮箱
$ git config --local user.name "姓名"
$ git config --local user.email "你的邮箱地址"

# 检查 git 的某一项配置
$ git config user.name
$ git config user.email

# 删除配置
$ git config --unset --global user.name
$ git config --unset --global user.email

# 记住提交账号密码, 下次操作可免账号密码
$ git config --global credential.helper store   # 永久
$ git config --global credential.helper cache   # 临时，默认15分钟

# windows 文件设置为大小写敏感
$ git config core.ignorecase false

# 忽略目录安全限制
$ git config --global --add safe.directory "*"

2. 初始化仓库

# 当前目录生成 .git 文件
$ git init

# 在当前目录下创建一个裸仓库，里面只有 .git 下的所有文件
$ git init --bare

# 新建一个目录并初始化
$ git init <project-name>

3. 克隆项目

# 下载远程项目
$ git clone <url>

# 克隆指定分支并切换到 gh-pages 分支上
$ git clone -b gh-pages git@github.com:sg996/vue3-todo-list.git

4. 管理仓库

• git remote 命令用来管理远程仓库。
• 通常一个项目对应多个仓库就需要用到 git remote， 比如要推送到 GitHub / Gitee / GitLab， 就可以用 git remote 来管理多个仓库地址。
• origin 是仓库默认名字。

# 查看当前项目远程仓库名称
# （一般打印 origin，这是仓库默认名字，除非有多个远程仓库地址。）
$ git remote

# 查看当前项目远程仓库地址
$ git remote -v

# 自定义远程仓库名称（example 是自定义名字） 
$ git remote add <example> git@github.com:sg996/vue3-todo-list.git

# 查看指定远程仓库信息
$ git remote show <example>

# 重命名远程仓库
$ git remote rename <oldName> <newName>

# 移除远程仓库
$ git remote remove <example>

# 修改远程仓库地址，从HTTPS更改为SSH
$ git remote set-url origin git@github.com:sg996/vue3-todo-list.git

# 推送指定仓库
$ git push <example>

5. 暂存文件

# 暂存所有
$ git add -A

# 暂存某个文件
$ git add ./README.md

# 暂存当前目录所有改动文件
$ git add .

# 暂存一系列文件
$ git add 1.txt 2.txt ...

6. 提交文件

# 提交的描述信息
$ git commit -m "changes log"

# 只提交某个文件
$ git commit README.md -m "message"

# 提交并显示diff变化
$ git commit -v

# 允许提交空消息，通常必须指定 -m 参数
$ git commit --allow-empty-message

# 重写上一次提交信息，确保当前工作区没有改动
$ git commit --amend -m "new message"

# 跳过验证，如果使用了类似 husky 工具。
$ git commit -m "message" --no-verify

7. 推送远端

# 默认推送当前分支
# （等价于 git push origin，实际上推送到一个叫 origin 默认仓库名字）
$ git push

# 推送到主分支
$ git push -u origin main

# 本地分支推送到远端分支， 本地分支:远端分支
$ git push origin <branch-name>:<branch-name>

# 强制推送, --force 缩写
$ git push -f git@github.com:sg996/vue3-todo-list.git main

8. 查看分支

# 查看所有分支
$ git branch -a

# 查看本地分支
$ git branch

# 查看远程分支
$ git branch -r

# 查看本地所关联的远程分支
$ git branch -v

# 查看本地与远程分支映射关系
$ git branch -vv

# 打开官方帮助文档
$ git branch --help

9. 切换分支一

# 切换到指定分支
$ git checkout <branch-name>

# 切换上一个分支
$ git checkout -

# 强制切换（如果文件未保存修改会直接覆盖掉）
$ git checkout -f main

# 创建分支并切换
$ git checkout -b <branch-name>

# 强制创建分支（不切换分支）
$ git checkout -B <branch-name>

# 切换远程分支（如果用了 git remote 添加一个新仓库就需要用 -t 进行切换）
$ git checkout -t upstream/main

10. 切换分支二

• git switch 命令在git版本 2.23 引入, 用于切换分支。
• git checkout 同样可以切换分支, git switch 意义在哪里？ 因为 git checkout 不但可以切换分支还可以撤销工作，导致命令含糊不清，所以引入了 git switch。 :::

# 切换到指定分支
$ git switch <branch-name>

# 切换到上一个分支
$ git switch -

# 强制切换（如果文件未保存修改会直接覆盖掉）
$ git switch -f main

# 创建分支并切换
$ git switch -c <branch-name>

# 强制创建分支（不切换分支）
$ git switch -C <branch-name>

# 切换远程分支（如果用了 git remote 添加一个新仓库就需要用 -t 进行切换）
$ git switch -t upstream/main

11. 创建分支

# 创建分支
$ git branch <branch-name>

# 强制创建分支（不输出任何警告或信息）
$ git branch -f <branch-name>

# 创建分支并切换
$ git checkout -b <branch-name>

# 强制创建分支（不切换分支）
$ git checkout -B <branch-name>

# 创建分支并切换
$ git switch -c <branch-name>

# 强制创建分支（不切换分支）
$ git switch -C <branch-name>

12. 检出远程分支

# 检出远程所有分支
$ git fetch

# 检出远程指定分支
$ git fetch origin :<branch-name>
# 等价于
$ git fetch origin master:<branch-name>

# 拉取远程分支并创建本地分支
# 方式一：（建立的本地分支会和远程分支建立映射关系，自动切换分支）
$ git checkout -b <branch-name> origin/<branch-name>

# 方式二：（建立的本地建立分支不会和远程分支建立映射关系）
$ git fetch origin <branch-name>:<branch-name>
# 推送需注意
$ git branch --set-upstream-to=<branch-name> origin/<branch-name>

13. 删除分支

# 删除指定分支
$ git branch -d <branch-name>

# 强制删除未完全合并的分支
$ git branch -D <branch-name>
# 等价于
$ git branch --delete --force <branch-name>

# 删除远程分支
$ git push origin :<branch-name>
$ git push origin --delete <branch-name>

14. 重命名分支

# 修改分支名称
$ git branch -m <branch-name>

# 强制修改分支名称
$ git branch -M <branch-name>

# 删除远程旧分支
$ git push origin :<old-branch>

# 将重命名分支推送到远程
$ git push -u origin <new-branch>

# 重命名指定分支
$ git branch -m <old-branch> <new-branch>

15. 临时保存

# 保存当前修改工作区内容
$ git stash

# 保存时添加注释（推荐使用此命令）
$ git stash save "修改了#28 Bug"

# 保存包含没有被git追踪的文件
$ git stash -u

# 查看当前保存列表
$ git stash list

# 恢复修改工作区内容，会从 git stash list 移除掉
# 恢复最近一次保存内容到工作区，默认会把暂存区的改动恢复到工作区
$ git stash pop 
# 恢复指定 id，通过 git stash list 可查到
$ git stash pop stash@{1} 
# 恢复最近一次保存内容到工作区，但如果是暂存区的内容同样恢复到暂存区
$ git stash pop --index 

# 与 pop 命令一致，唯一不同的是不会移除保存列表
$ git stash apply

# 清空所有保存
$ git stash clear

# 清空指定 stash id，如果 drop 后面不指定id清除最近的一次
$ git stash drop stash@{0}
# 清除最近一次
$ git stash drop

16. 文件状态

# 完整查看文件状态
$ git status

# 以短格式给出输出
$ git status -s

# 忽略子模块
$ git status --ignore-submodules

# 显示已忽略的文件
$ git status --ignored

17. 日志

• 查看历史日志可以通过 git log / git shortlog / git reflog。 :::

# 查看完整历史提交记录
$ git log

# 查看前N次提交记录 commit message
$ git log -2

# 查看前N次提交记录，包括diff
$ git log -p -2

# 从 commit 进行搜索, 可以指定 -i 忽略大小写
$ git log -i --grep="fix: #28"

# 从工作目录搜索包含 alert(1) 这段代码何时引入
$ git log -S "alert(1)"

# 查看指定作者历史记录
$ git log --author=源代码

# 查看某个文件的历史提交记录
$ git log README.md

# 只显示合并日志
$ git log --merges

# 以图形查看日志记录, --oneline 可选
$ git log --graph --oneline

# 以倒序查看历史记录
$ git log --reverse

git shortlog 以简短的形式输出日志，通常用于统计贡献者代码量。

# 默认以贡献者分组进行输出
$ git shortlog

# 列出提交者代码贡献数量，打印作者和贡献数量
$ git shortlog -sn

# 以提交贡献数量排序并打印出message
$ git shortlog -n

# 采用邮箱格式化的方式进行查看贡献度
$ git shortlog -e

git reflog 通常被引用为 安全网，当 git log 没有想要的信息时可以尝试用 git reflog。

# 当回滚某个版本时记录是不保存在 git log 中，想要找到这条回滚版本信息时 git reflog 就用上了。
$ git reflog 
# 等价于 
$ git log -g --abbrev-commit --pretty=oneline

18. 回滚版本

回滚版本有 2 种方法：

• git reset - 回滚版本后之前的历史记录将不保存, 不保留痕迹, 基本上不存在冲突情况。
• git revert - 回滚版本后之前的历史记录还存在并多增加了一条 Revert 记录，很容易出现冲突。 :::

# 回滚上一个版本 (不删除工作空间的改动代码 ，撤销commit，不撤销add)
$ git reset --soft HEAD^

# 回滚上一个版本（删除工作空间的改动代码，撤销commit且撤销add）
$ git reset --hard HEAD^

# 回滚上两个版本
$ git reset --hard HEAD^^

# 回滚到指定 commit_id，对应 hash 值
# 通过 git log / git reflog 查看
$ git reset --hard <hash 值>

# 回滚后但未推送到远程想断开当前操作执行拉取即可：
$ git pull

# 推送
$ git push -f

# 回滚上一次提交版本
$ git revert HEAD^

# 回滚指定commit
$ git revert 8efef3d37

# --no-edit 回滚并跳过编辑消息
$ git revert HEAD^ --no-edit

# 断开当前操作，还原初始状态
$ git revert --abort

# 推送到远程，假设当前是 main 分支
$ git push -u origin main

# 回滚到指定分支或Commit_id指定文件, 命令：
$ git checkout main 1.txt 2.txt

$ git checkout 8efef3d37 1.txt 2.txt