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
# 回滚merge,并丢弃(存在冲突)
git merge --abort