Git 常用操作与使用场景手册

git config --global user.name "你的名字"git config --global user.email "you@example.com"# 查看所有配置git config --list# 设置默认分支名为 maingit config --global init.defaultBranch main# 让 Git 记住账号密码,避免每次输入git config --global credential.helper store

# 进入项目目录后执行(去掉 --global)git config user.name "工作名"git config user.email "work@company.com"

git config --global alias.st statusgit config --global alias.co checkoutgit config --global alias.br branchgit config --global alias.ci commitgit config --global alias.lg "log --graph --oneline --all"# 之后可用 git lg 查看漂亮的提交树

cd your-projectgit initgit add .git commit -m "init: 初始化项目"

# HTTPS 方式(简单,适合新人)git clone https://github.com/user/repo.git# SSH 方式(免密,推荐长期使用)git clone git@github.com:user/repo.git# 克隆到指定目录git clone git@github.com:user/repo.git my-folder# 只克隆最近一次提交(大仓库加速)git clone --depth 1 git@github.com:user/repo.git

git remote add origin git@github.com:user/repo.gitgit branch -M maingit push -u origin main

git status              # 查看哪些文件改了git status -s           # 简短模式git diff                # 查看未暂存的具体改动git diff --staged       # 查看已暂存但未提交的改动git diff HEAD           # 查看所有未提交的改动

git add index.html              # 暂存单个文件git add src/                    # 暂存整个目录git add .                       # 暂存所有改动(含新增)git add -u                      # 只暂存已跟踪文件的修改(不含新文件)git add -p                      # 交互式选择部分改动暂存(同一文件可拆分提交)

git commit -m "feat: 新增用户登录功能"git commit -m "标题" -m "详细描述"   # 标题 + 正文git commit --amend                  # 修改最近一次提交(未 push 时用)git commit --amend --no-edit        # 把新改动并入上次提交,不改 message

git push                           # 推到默认远程的默认分支git push origin main               # 明确指定git push -u origin feature/login   # 首次推送新分支并建立跟踪git push --force-with-lease         # 安全的强推(见下方说明)

<type>(<scope>): <subject><body><footer>

git branch                     # 查看本地分支git branch -a                  # 查看所有分支(含远程)git branch -vv                 # 查看分支跟踪关系git branch feature/login       # 创建分支但不切换git switch feature/login       # 切换分支(新命令,推荐)git checkout feature/login     # 切换分支(老命令)git switch -c feature/login    # 创建并切换git checkout -b feature/login  # 创建并切换(老写法)

git fetch origingit switch feature/pay         # 自动跟踪同名远程分支

git branch -m new-name         # 重命名当前分支git branch -m old-name new-name # 重命名指定分支# 已推送的分支重命名后,需要删除远程旧分支再推新分支git push origin :old-namegit push -u origin new-name

git branch -d feature/login        # 安全删除(未合并会提醒)git branch -D feature/login        # 强制删除git push origin --delete feature/login  # 删除远程分支

git switch maingit merge feature/login

git switch feature/logingit rebase main# 如有冲突:解决后 git add,再 git rebase --continue

git switch maingit merge --squash feature/logingit commit -m "feat: 新增登录功能"

git switch maingit cherry-pick <commit-hash>

git merge --abort              # 合并冲突时放弃合并git reset --hard HEAD~1        # 合并完成后撤销

git restore index.html         # 新命令,推荐git checkout -- index.html     # 老写法

git restore --staged index.htmlgit reset HEAD index.html       # 老写法

# 只改 messagegit commit --amend -m "新的 message"# 把新改动并入上次提交git add .git commit --amend --no-edit

git reset --soft HEAD~3     # 保留改动在暂存区git reset --mixed HEAD~3    # 保留改动在工作区(默认)git reset --hard HEAD~3     # 完全丢弃改动(危险)

git revert <commit-hash>          # 撤销单次提交git revert HEAD                   # 撤销最近一次git revert HEAD~2..HEAD           # 撤销最近 3 次提交

git reflog                    # 查看所有 HEAD 移动记录git switch -c feature/recovered <reflog-hash>

git remote -v                          # 查看远程地址git remote add origin git@...           # 添加远程git remote set-url origin git@...       # 修改远程地址git remote remove origin                # 删除远程

git remote add origin git@github.com:你/repo.git      # 自己的 forkgit remote add upstream git@github.com:原作者/repo.git # 上游# 同步上游更新git fetch upstreamgit switch maingit merge upstream/maingit push origin main

git fetch origin          # 拉取远程更新但不合并(安全)git pull                  # = fetch + merge(可能产生冲突)git pull --rebase         # = fetch + rebase(更干净)

git stash                  # 保存当前改动到栈git stash push -m "登录功能写一半"   # 带说明git switch main# ...修 bug、提交、推送 ...git switch feature/logingit stash pop              # 取出最近的 stash 并删除git stash list             # 查看所有 stashgit stash apply stash@{1}  # 取出指定 stash 但不删除git stash drop stash@{0}   # 删除指定 stash

git stash push -m "仅暂存配置" -- config.yml

git stash -u

git log                                # 完整日志git log --oneline                      # 每行一条git log --oneline --graph --all        # 图形化所有分支git log --author="张三"                 # 按作者过滤git log --since="2 weeks ago"          # 按时间过滤git log -p index.html                  # 查看某文件的修改历史git log -S "loginUser"                 # 查看包含某字符串的提交

git show <commit-hash>git show HEAD                  # 最近一次git show HEAD~2                # 倒数第三次

git blame index.htmlgit blame -L 50,80 index.html   # 只看 50-80 行

git log --grep="登录"            # 按 message 搜索git log -- source/              # 只看某目录的提交

# 轻量标签git tag v1.0.0# 附注标签(推荐,带说明)git tag -a v1.0.0 -m "正式发布版本 1.0.0"# 推送标签到远程git push origin v1.0.0git push origin --tags          # 推送所有标签# 查看标签git taggit show v1.0.0# 删除标签git tag -d v1.0.0                       # 删本地git push origin --delete v1.0.0         # 删远程# checkout 到某个版本git checkout v1.0.0

CONFLICT (content): Merge conflict in index.html

git status                      # 看哪些文件冲突# 打开文件,手动解决冲突标记# <<<<<<< HEAD# 我的代码# =======# 对方代码# >>>>>>> feature/logingit add index.html              # 解决后标记为已解决git commit                      # merge 时完成合并提交# 或 rebase 时:git rebase --continue

git merge --abort       # 取消 mergegit rebase --abort      # 取消 rebase

# 1. 同步最新主分支git switch maingit pull --rebase origin main# 2. 创建功能分支git switch -c feature/user-export# 3. 开发过程中频繁小提交git add .git commit -m "feat: 导出按钮 UI"# 4. 中途同步 main 更新git fetch origingit rebase origin/main# 5. 推送到远程git push -u origin feature/user-export# 6. 在 GitLab/GitHub 提 Merge Request / Pull Request# 7. Code Review 通过后合并到 main,删除功能分支

# 1. 从 main 拉出 hotfix 分支git switch maingit pullgit switch -c hotfix/payment-crash# 2. 修复并测试git commit -m "fix: 修复支付回调崩溃"# 3. 合并到 main 并打标签git switch maingit merge --no-ff hotfix/payment-crashgit tag -a v1.2.1 -m "修复支付崩溃"# 4. 推送git push origin main --tags# 5. 如果有 develop 分支,也要同步git switch developgit merge hotfix/payment-crash# 6. 清理git branch -d hotfix/payment-crashgit push origin --delete hotfix/payment-crash

# 拉取同事的提交git pull --rebase origin feature/login# 如有冲突:解决 → git add → git rebase --continue# 推送自己的提交git push origin feature/login# 如果同事在你 pull 后又 push 了,push 会失败git pull --rebase origin feature/logingit push origin feature/login

# 方案 A:用 revert 反向提交(推荐,安全)git switch maingit revert <有问题的 commit hash>git push origin main# 方案 B:回退到指定版本(需强推,慎用)git reset --hard v1.0.0git push --force-with-lease origin main

# 假设误提交了 2 次git switch -c feature/oops         # 先把这些提交带到新分支git switch maingit reset --hard HEAD~2            # main 回退 2 次git switch feature/oops            # 继续在 feature 上开发

# 把 feature 分支的 utils.js 合到 main,不要其他改动git switch maingit checkout feature/xxx -- utils.jsgit commit -m "chore: 同步 utils.js"

# 添加子模块git submodule add git@github.com:team/common-ui.git src/common-ui# 克隆含子模块的项目git clone --recurse-submodules git@github.com:user/repo.git# 已克隆项目后初始化子模块git submodule update --init --recursive# 更新子模块到最新git submodule update --remote

git lfs installgit lfs track "*.psd"git lfs track "*.mp4"git add .gitattributes

git bisect startgit bisect bad                    # 标记当前是坏的git bisect good v1.0.0            # 标记 v1.0.0 是好的# Git 自动 checkout 中间提交,你测试后:git bisect good   # 或 git bisect bad# 重复几次,Git 会定位到具体哪次提交引入的 buggit bisect reset                  # 结束

git commit --amend -m "正确的 message"git push --force-with-lease origin feature/xxx

git reflog              # 找到误操作前的 hashgit reset --hard <hash>

git rebase -i HEAD~3    # 交互式 rebase# 把要拆的提交标记为 edit# Git 停在该提交后:git reset HEAD~git add -p              # 分批暂存git commit -m "第一部分"git add .git commit -m "第二部分"git rebase --continue

# 浅克隆git clone --depth 1 <url># 只克隆最近 N 次提交git clone --depth 10 <url># 只克隆指定分支git clone --branch main --single-branch <url>

node_modules/*.log.envdist/.vscode/*.local

git log --oneline -- path/to/filegit show <commit-hash>:path/to/file    # 查看历史版本内容

git reset --hard ORIG_HEAD    # 回到 merge 之前

main(永远可部署) └── feature/xxx → PR → review → merge