1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# 查看所有本地分支（带 * 的是当前分支）
git branch

# 创建分支（不切换）
git branch feature-login

# 创建并切换（现代写法）
git switch -c feature-login

# 基于某个提交/标签创建分支
git switch -c hotfix-v1 v1.0.0

# 切回上一个分支（在两个分支之间来回跳，很实用）
git switch -

1
2
3
4
5
6
7
8

git branch                # 本地分支
git branch -r             # 远程分支
git branch -a             # 本地 + 远程
git branch -v             # 带每个分支的最新提交
git branch -vv            # 再加上"跟踪的是哪个远程分支、领先/落后多少"
git branch --merged       # 已经合并进当前分支的（可以安全删除）
git branch --no-merged    # 还没合并的（删了会丢东西）
git branch --sort=-committerdate    # 按最近提交时间排序

1
2

* main    a1b2c3d [origin/main: ahead 2, behind 1] fix: 修复登录
  feature e4f5g6h [origin/feature] feat: 开发中

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

# 删除已合并的分支（安全，Git 会检查）
git branch -d feature-login

# 强制删除（未合并也会删，会丢提交！）
git branch -D feature-login

# 删除远程分支
git push origin --delete feature-login
# 老写法：git push origin :feature-login（冒号前面为空，等于推一个空分支上去）

# 重命名【当前】分支：只写一个新名字
git branch -m main-new

# 重命名【其他】分支：写旧名和新名
git branch -m old-name new-name

# 重命名后同步远程：删旧的、推新的、重设上游
git push origin --delete old-name
git push -u origin main-new

1
2

git switch main
git merge feature-login

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 想保留"这里合并过一个功能分支"的痕迹，强制生成合并提交
git merge --no-ff feature-login

# 想保证历史是一条直线，不允许产生合并提交
git merge --ff-only feature-login

# 把分支上的所有提交压成一个未提交的改动，攒好后自己提交一次
git merge --squash feature-login
git commit -m "feat: 完成登录模块（squash 自 feature-login）"

# 合并到一半发现不对劲，撤销
git merge --abort

1
2
3
4
5

  <<<<<<< HEAD
  当前所在分支（ours）的内容
  =======
  被合并进来的分支（theirs）的内容
  >>>>>>> feature-login

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16

git merge feature-login
# CONFLICT (content): Merge conflict in app.py
# Automatic merge failed; fix conflicts and then commit the result.

git status                 # 会看到 both modified: app.py

# 打开 app.py，把 <<<<<<< ======= >>>>>>> 三行连同你不想要的内容一起删掉，
# 保留（或合并）真正需要的代码

git add app.py             # 标记为已解决
git commit                 # 完成合并（Git 会预填好提交信息）
# 或者
git merge --continue

# 后悔了
git merge --abort

1
2
3
4
5

git checkout --ours   app.py    # 保留当前分支的版本
git checkout --theirs app.py    # 保留被合并分支的版本
# 或者用 Git 2.23+ 的写法
git restore --ours    app.py
git restore --theirs  app.py

1
2
3

git mergetool                       # 用配置好的工具逐个处理冲突
git config --global merge.tool vimdiff
git config --global mergetool.keepBackup false   # 不留 .orig 备份文件

1
2

git config --global rerere.enabled true
# 之后同一个冲突再次出现，Git 会直接套用上次的解法，只需确认结果

1
2

git switch feature
git rebase main

1
2

git rebase -i HEAD~3      # 编辑最近 3 个提交
git rebase -i main        # 编辑"从 main 分出来之后"的所有提交

1
2
3
4

pick a1b2c3 feat: 添加登录接口
fixup d4e5f6 修正拼写
fixup 7g8h9i 再修一次拼写
reword j0k1l2 feat: 添加登录接口的单元测试

1
2
3

git rebase --continue    # 解决冲突后继续
git rebase --skip        # 跳过当前这个提交
git rebase --abort       # 整个放弃，回到变基前的状态

1
2
3
4
5
6

# ❌ 危险：不管远程现在是什么状态，一律覆盖
git push --force

# ✅ 推荐：只有当远程还是你上次拉取时的样子才覆盖，
#    万一别人在这期间推过东西，就会失败并保护他的提交
git push --force-with-lease

1
2

git pull --rebase
git config --global pull.rebase true    # 让以后默认走这条路径

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12

# 轻量标签：只是一个指向提交的指针，不记录额外信息
git tag v1.0.0

# 附注标签（推荐）：是一个完整的对象，包含打标签的人、时间、说明，
# 还能用 GPG 签名
git tag -a v1.0.0 -m "1.0.0 正式发布"

# 给历史提交补打标签
git tag -a v0.9.0 abc1234 -m "0.9.0 内测版"

# 签名标签
git tag -s v1.1.0 -m "1.1.0（已签名）"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

git tag                       # 列出所有标签
git tag -l "v1.*"             # 按模式筛选
git tag -l --sort=-v:refname  # 按版本号语义排序（不是字符串排序）
git show v1.0.0               # 标签详情 + 对应提交
git describe --tags           # 从当前提交往回找最近的标签，如 v1.0.0-12-gabc1234

# 推送：只推送指定标签
git push origin v1.0.0

# 推送所有本地标签（会推很多，慎用）
git push --tags

# 更好的做法：推送分支时顺带推送"由这次推送可达的附注标签"
git push --follow-tags

1
2
3
4
5
6
7
8

git tag -d v1.0.0                    # 删本地
git push origin --delete v1.0.0      # 删远程
# 老写法：git push origin :refs/tags/v1.0.0

# 检出到某个标签：这会让 HEAD 处于"游离"状态（detached HEAD）
git switch --detach v1.0.0
# 想基于标签继续开发，就新建一个分支
git switch -c hotfix-v1 v1.0.0

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# --soft：只移动指针。改动全部保留在【暂存区】
git reset --soft HEAD~1
# 用途：提交信息写错了/想把最近 3 个提交合成 1 个，再重新 commit
git reset --soft HEAD~3
git commit -m "feat: 把 3 次提交合成一次"

# --mixed（默认）：移动指针 + 清空暂存区，改动保留在【工作区】
git reset HEAD~1
git reset            # 不带参数 = 取消所有暂存（git restore --staged 的等价物）
git reset app.py     # 只取消一个文件的暂存

# --hard：移动指针 + 清空暂存区 + 覆盖工作区
git reset --hard HEAD~1
# ⚠️ 未提交的改动会彻底消失，用之前先 git status / git stash

1
2
3
4

# 把当前分支重置到远程的样子（本地乱改一通之后的"重开"）
git fetch origin
git reset --hard origin/main
# ⚠️ 这条命令会删掉你所有本地未推送的提交

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

# 生成一个反向提交，抵消 abc1234 的改动
git revert abc1234

# 撤销多个提交
git revert abc1234 def5678

# 先不自动提交，攒几个反向改动一起提交
git revert -n abc1234
git commit -m "revert: 撤销误合并的登录改动"

# 撤销一个合并提交（-m 1 表示以第 1 个父提交为主线保留）
git revert -m 1 <merge-commit-hash>

# 冲突了
git revert --continue   # 或 --abort / --skip

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

git reflog
# a1b2c3d HEAD@{0}: reset: moving to HEAD~3
# e4f5g6h HEAD@{1}: commit: 添加用户认证
# i7j8k9l HEAD@{2}: rebase (finish): returning to refs/heads/feature

# 误删的分支：找到它当时的提交，再建回来
git switch -c feature-recovered e4f5g6h

# 误 reset / 误 rebase 的提交：把分支挪回去
git reset --hard HEAD@{1}

# 误 amend 的提交：amend 会把旧提交记在 ORIG_HEAD
git reset --hard ORIG_HEAD

1
2
3
4
5
6
7

git remote -v                                  # 查看远端及地址
git remote add origin git@github.com:user/repo.git
git remote add gitee  git@gitee.com:user/repo.git
git remote rename origin github
git remote remove gitee
git remote show origin                          # 详情：跟踪了哪些分支、本地分支的上游
git remote set-url origin git@github.com:user/repo.git   # 换地址（HTTPS ↔ SSH）

1
2
3

git clone git@github.com:your-name/repo.git
cd repo
git remote add upstream git@github.com:original-owner/repo.git

1
2
3
4
5
6
7

git fetch origin                # 只下载，不动你的代码
git log HEAD..origin/main --oneline   # 看远程比我多了哪些提交
git diff HEAD origin/main --stat      # 看具体改了哪些文件
git merge origin/main           # 确认没问题再合并（或 git rebase origin/main）

git fetch --all                 # 拉取所有远程
git fetch --prune               # 顺手清理"远程已经删掉、本地还在"的跟踪分支

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# 第一次推送新分支，并设置上游（之后就能直接 git push）
git push -u origin feature-login

# 之后
git push

# 推送指定分支
git push origin main

# 推送所有本地分支
git push --all

# 删除远程分支
git push origin --delete old-branch

# 强制推送（变基之后）——一律用 --force-with-lease
git push --force-with-lease

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

git stash                       # 收起已跟踪文件的改动
git stash push -m "登录表单半成品"    # 带说明（比老的 stash save 更推荐）
git stash -u                    # 连未跟踪的新文件一起收
git stash push -- app.py config.ini   # 只收指定文件

git stash list
# stash@{0}: On main: 登录表单半成品
# stash@{1}: WIP on feature: a1b2c3d feat: ...

git stash show -p stash@{0}     # 看 stash 里到底是什么
git stash apply stash@{0}       # 恢复，但保留这条 stash（可重复用）
git stash pop                   # 恢复并删除这条 stash（最常用）
git stash drop stash@{0}        # 删掉一条
git stash clear                 # 清空全部（不可恢复）

1
2
3
4
5
6
7
8

git switch release/1.8
git cherry-pick a1b2c3d            # 把 main 上的这个修复搬到当前分支
git cherry-pick a1b2c3d e4f5g6h    # 一次挑多个
git cherry-pick a1b2c3d^..e4f5g6h  # 挑一个区间

git cherry-pick -n a1b2c3d         # 只改工作区，不自动提交
git cherry-pick --continue         # 解决冲突后继续
git cherry-pick --abort            # 放弃

1
2

git switch release/1.8
git cherry-pick a1b2c3d

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

git bisect start
git bisect bad                 # 当前版本是坏的
git bisect good v1.0.0         # 这个旧版本是好的（或写一个提交哈希）

# Git 会自动切换到中间的那个提交，你编译/测试后告诉它结果
git bisect good                # 或 git bisect bad
# 反复几次后：
# a1b2c3d is the first bad commit

git bisect reset               # 结束，回到原来的分支

1

git bisect run ./test.sh       # 脚本返回 0 表示这个提交是好的

1
2
3
4
5

git worktree add ../repo-hotfix hotfix/login
cd ../repo-hotfix        # 一个独立目录，但共享同一个 .git

git worktree list        # 看有哪些工作树
git worktree remove ../repo-hotfix   # 用完删掉

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

git submodule add https://github.com/user/lib.git libs/lib

# 克隆带子模块的仓库（必须显式要求，否则子模块目录是空的）
git clone --recurse-submodules https://github.com/user/main-repo.git

# 已经克隆了，事后补上
git submodule update --init --recursive

# 更新子模块到它记录的新提交
git submodule update --remote --merge

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 安装（每个使用仓库的人都要装）
sudo apt install git-lfs          # Debian/Ubuntu
brew install git-lfs              # macOS

git lfs install                   # 在本机启用，每台机器一次
git lfs track "*.psd" "*.mp4"     # 声明哪些文件走 LFS，会写入 .gitattributes
git add .gitattributes           # ⚠️ 这个文件必须提交，否则别人拉下来不知道规则

git lfs ls-files                  # 看哪些文件在 LFS 里
git lfs status

# 把已经提交进普通 Git 历史的大文件迁移到 LFS（会重写历史！）
git lfs migrate import --include="*.psd"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

# Git Flow 本身是一个独立工具（git-flow），不是 Git 内置命令
# Debian/Ubuntu: sudo apt install git-flow
# macOS:         brew install git-flow-avh

git flow init                                    # 初始化，采用默认分支命名

git flow feature start user-login                # 从 develop 拉出 feature/user-login
git flow feature finish user-login               # 合并回 develop 并删除该分支

git flow release start 1.0.0                     # 拉出 release/1.0.0
git flow release finish 1.0.0                    # 合并到 main、打标签、再合并回 develop

git flow hotfix start login-crash                # 从 main 拉出，修线上故障
git flow hotfix finish login-crash

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19

# 1. 在网页上点 Fork，得到 your-name/repo
# 2. 克隆自己的 Fork
git clone git@github.com:your-name/repo.git
cd repo

# 3. 把原项目加为 upstream，方便同步
git remote add upstream git@github.com:original-owner/repo.git
git remote -v        # 应该能看到 origin 和 upstream 两个

# 4. 从最新的 upstream 拉出功能分支
git fetch upstream
git switch -c fix/typo-in-readme upstream/main

# 5. 开发、提交、推送到自己的 Fork
git add .
git commit -m "docs: 修正 README 中的命令拼写"
git push -u origin fix/typo-in-readme

# 6. 在网页上创建 Pull Request，源分支选自己的，目标分支选原项目的 main

1
2
3
4

git fetch upstream
git switch main
git merge --ff-only upstream/main     # 或 git rebase upstream/main
git push origin main

1
2
3

git add .
git commit -m "refactor: 按评审意见简化判断逻辑"
git push

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

jobs:
  test:
    runs-on: ubuntu-latest

    steps:
      - uses: actions/checkout@v4

      - name: 安装 Node.js
        uses: actions/setup-node@v4
        with:
          node-version: '22'
          cache: 'npm'          # 自动缓存 npm 依赖，显著加快后续构建

      - name: 安装依赖
        run: npm ci             # 比 npm install 更适合 CI：严格按 lock 文件安装

      - name: 代码检查
        run: npm run lint

      - name: 运行测试
        run: npm test

      - name: 构建
        run: npm run build

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36

stages:
  - test
  - build
  - deploy

default:
  image: node:22
  cache:
    key: "$CI_COMMIT_REF_SLUG"
    paths:
      - .npm/

test:
  stage: test
  script:
    - npm ci --cache .npm --prefer-offline
    - npm run lint
    - npm test

build:
  stage: build
  script:
    - npm ci --cache .npm --prefer-offline
    - npm run build
  artifacts:
    paths:
      - dist/
    expire_in: 1 week

deploy:
  stage: deploy
  script:
    - echo "部署到生产环境..."
  # 用 rules 代替已被弃用的 only / except
  rules:
    - if: '$CI_COMMIT_BRANCH == "main"'

1
2
3
4
5

<类型>(<范围>): <简短描述>

<可选正文：解释为什么这么改>

<可选脚注：BREAKING CHANGE、Closes #123>

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

# 单行提交
git commit -m "feat(auth): 添加用户登录功能"
git commit -m "fix(api): 修复用户查询接口的越权问题"

# 破坏性变更：类型后面加 !，并在正文里写 BREAKING CHANGE
git commit -m "feat(api)!: 调整响应结构为 data/meta 两层"

# 多行提交：用多个 -m，每个 -m 会成为一段
git commit -m "feat(auth): 支持 OAuth2 登录" \
           -m "- 新增 GitHub 登录
- 新增 Google 登录
- 登录态使用 JWT" \
           -m "Closes #142"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17

# 看有哪些可用钩子（默认都是 .sample，不会执行）
ls .git/hooks/

# 写一个 pre-commit 钩子
cat > .git/hooks/pre-commit << 'EOF'
#!/bin/bash
set -euo pipefail

# 对暂存区的文件跑 lint，不通过就不让提交
files=$(git diff --cached --name-only --diff-filter=ACM | grep -E '\.(js|ts|tsx)$' || true)
[[ -z "$files" ]] && exit 0

echo "正在检查: $files"
npx eslint $files
EOF

chmod +x .git/hooks/pre-commit