Git 速查手册

提炼 Git 初始配置、本地与远程仓库操作、分支协作和常用工作流。

约 1 分钟252 字#Git

Git 速查手册

[!abstract] 概览 本笔记提炼自Git 分布式版本控制工具，聚焦于日常操作命令与常用工作流，略去教程说明。

初始配置

shell
# 设置用户信息（首次使用必做）
git config --global user.name "Your Name"
git config --global user.email "you@example.com"

# 查看配置
git config --global user.name
git config --global user.email

# 修复中文路径乱码
git config --global core.quotepath false

[!tip] 推荐别名（写入 ~/.bashrc）

shell
alias git-log='git log --pretty=oneline --all --graph --abbrev-commit'
alias ll='ls -al'

保存后执行 source ~/.bashrc 生效。

本地仓库操作

基础流程

shell
git init                        # 初始化仓库
git status                      # 查看工作区/暂存区状态

git add <file>                  # 暂存指定文件
git add .                       # 暂存所有修改

git commit -m "message"         # 提交到本地仓库
git commit -a -m "message"      # 暂存已跟踪文件并提交（不含新文件）

查看日志

shell
git log                                              # 完整日志
git log --pretty=oneline --all --graph --abbrev-commit  # 图形化精简日志
git reflog                                           # 查看所有历史（含已删除提交）

版本回退

shell
git reset --hard <commitID>     # 回退到指定版本
# commitID 通过 git-log 或 git reflog 获取

忽略文件

在项目根目录创建 .gitignore：

text
*.log           # 忽略所有 .log 文件
build/          # 忽略整个目录
!lib.a          # 例外：不忽略 lib.a
/TODO           # 仅忽略根目录的 TODO
doc/**/*.pdf    # 忽略 doc 目录下所有 PDF

分支管理

shell
git branch                      # 查看本地分支
git branch <name>               # 创建分支
git checkout <name>             # 切换分支
git checkout -b <name>          # 创建并切换分支

git merge <branch>              # 将指定分支合并到当前分支
git branch -d <name>            # 删除分支（含安全检查）
git branch -D <name>            # 强制删除分支
git branch -vv                  # 查看本地与远程分支关联关系

[!warning] 切换分支前务必先提交当前修改

解决合并冲突

  1. 手动编辑冲突文件，处理 <<<<<<< / ======= / >>>>>>> 标记
  2. git add <file> — 标记冲突已解决
  3. git commit -m "resolve conflict"

分支规范

分支用途
master线上生产分支
develop日常开发主分支
feature/xxx新功能并行开发
hotfix/xxx线上 Bug 紧急修复

远程仓库操作

SSH 公钥配置（一次性）

shell
ssh-keygen -t rsa               # 生成密钥（一路回车）
cat ~/.ssh/id_rsa.pub           # 复制公钥，粘贴到 Gitee/GitHub 账号设置
ssh -T git@gitee.com            # 验证连接

常用命令

shell
# 关联远程仓库
git remote add origin <url>

# 查看 / 移除远程仓库
git remote
git remote remove origin

# 首次推送并建立追踪关系
git push --set-upstream origin master

# 后续推送（已关联分支可省略参数）
git push
git push origin <branch>
git push -f origin <branch>     # 强制推送（慎用）

# 克隆
git clone <url>                 # 克隆到自动生成的目录
git clone <url> <dir>           # 克隆到指定目录

# 拉取
git fetch                       # 抓取远程更新（不合并）
git pull                        # 拉取并自动合并（= fetch + merge）
git pull origin <branch>

常用工作流速查

日常开发提交

shell
git status
git add .
git commit -m "feat: 描述内容"
git push

新功能开发

shell
git checkout develop
git checkout -b feature/my-feature
# ... 开发 ...
git add . && git commit -m "feat: xxx"
git checkout develop
git merge feature/my-feature
git branch -d feature/my-feature
git push origin develop

拉取最新代码并推送

shell
git pull                        # 先拉取，解决冲突后
git push                        # 再推送

[!note] 原始教程 完整教程见Git 分布式版本控制工具，包含 IDEA 集成操作等图文说明。