1
# GitHub Flow 标准流程
2
# 1. 确保主分支最新
3
git checkout main && git pull origin main
4

5
# 2. 创建功能分支（命名规范：type/issue-number-description）
6
git checkout -b feature/123-add-user-auth
7

8
# 3. 开发并频繁提交
9
git add .
10
git commit -m "feat(auth): add login page
11

12
- Add login form component
13
- Connect to auth API
14
- Add form validation
15

16
Closes #123"
17

18
# 4. 推送并创建 Pull Request
19
git push -u origin feature/123-add-user-auth
20

21
# 5. PR 合并后删除分支
22
git checkout main
23
git pull origin main
24
git branch -d feature/123-add-user-auth

1
# trunk-based 开发流程
2
# 核心原则：小步快跑，频繁集成
3

4
# 1. 保持主干最新
5
git checkout main
6
git pull --rebase origin main
7

8
# 2. 创建短生命周期分支（建议 1-2 天内完成）
9
git checkout -b tiny-fix-123
10

11
# 3. 小粒度提交
12
git add -p  # 交互式暂存
13
git commit -m "fix: resolve null pointer in auth"
14

15
# 4. 快速合并（使用 rebase 保持线性历史）
16
git fetch origin
17
git rebase origin/main
18
git push origin HEAD
19

20
# 5. 使用 Feature Flags 控制未完成功能
21
# 代码中通过配置开关控制
22
if (featureFlags.isEnabled('new-auth')) {
23
  // 新功能代码
24
} else {
25
  // 旧功能代码
26
}

1
# 交互式变基最近 3 个提交
2
git rebase -i HEAD~3
3

4
# 编辑器中显示
5
# pick abc123 feat: add feature A
6
# squash def456 WIP: work on feature A
7
# squash ghi789 fix: typo in feature A
8
#
9
# 将 squash 改为 squash/s/drop/edit
10
# 保存后会将多个提交压缩为一个
11

12
# 变基过程中解决冲突
13
git rebase --continue   # 解决冲突后继续
14
git rebase --abort      # 放弃变基
15
git rebase --skip       # 跳过当前提交
16

17
# 黄金法则：不要对已推送的提交进行变基
18
# 如果必须，需要通知团队成员
19
git push --force-with-lease  # 更安全的强制推送

1
# 合并策略选择
2

3
# 1. Fast-Forward（默认，无分叉）
4
git merge feature
5
# 条件：main 没有新提交
6

7
# 2. No-Fast-Forward（保留分支历史）
8
git merge --no-ff feature
9
# 推荐：功能分支合并时使用
10

11
# 3. Squash Merge（压缩为一个提交）
12
git merge --squash feature
13
git commit -m "feat: add feature X"
14
# 推荐：清理后的功能分支
15

16
# 4. Rebase then Merge（线性历史）
17
git checkout feature
18
git rebase main
19
git checkout main
20
git merge feature
21
# 推荐：保持历史整洁
22

23
# 解决冲突时的策略
24
git merge -X theirs feature   # 优先使用 feature 的版本
25
git merge -X ours feature     # 优先使用当前分支的版本

1
# 查找提交
2
git log --grep="fix bug"
3
git log -S "function_name"  # 代码变更
4
git log --author="name"
5
git log --after="2024-01-01"
6

7
# 恢复删除的提交
8
git reflog
9
git checkout HEAD@{N}  # 恢复到第 N 个操作
10

11
# 恢复删除的文件
12
git checkout HEAD -- deleted-file.txt
13
git restore --source=HEAD deleted-file.txt
14

15
# 查找 bug 引入的提交
16
git bisect start
17
git bisect bad
18
git bisect good <good-commit>

1
# 暂存部分修改
2
git add -p  # 交互式暂存
3

4
# 创建补丁
5
git diff > feature.patch
6
git diff --staged > staged.patch
7

8
# 应用补丁
9
git apply feature.patch
10

11
# 暂存工作进度
12
git stash push -m "wip: feature X"
13
git stash list
14
git stash pop
15
git stash apply stash@{0}

1
## PR 描述模板
2

3
### 背景
4

5
为什么需要这个变更？
6

7
### 变更内容
8

9
- 具体做了什么
10

11
### 测试验证
12

13
- [ ] 单元测试通过
14
- [ ] 集成测试通过
15
- [ ] 本地验证
16

17
### 截图/日志
18

19
如有 UI 变更或重要日志
20

21
### 关联 Issue
22

23
Closes #123

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
- [ ] 向后兼容

1
## 审查意见模板
2

3
### 问题级别
4

5
- [blocker] 必须修改 - 代码有问题
6
- [major] 建议修改 - 有更好的方案
7
- [minor] 可选修改 - 代码风格等
8
- [praise] 值得表扬 - 优秀实现
9

10
### 示例
11

12
[blocker] 这段代码存在空指针风险，建议增加空检查：
13

14
```java
15
if (user != null) {
16
    user.doSomething();
17
}
18
```

1
# ArgoCD 应用定义
2
apiVersion: argoproj.io/v1alpha1
3
kind: Application
4
metadata:
5
  name: my-app
6
  namespace: argocd
7
spec:
8
  project: default
9
  source:
10
    repoURL: https://github.com/org/repo
11
    targetRevision: HEAD
12
    path: deploy/k8s
13
  destination:
14
    server: https://kubernetes.default.svc
15
    namespace: production
16
  syncPolicy:
17
    automated:
18
      prune: true
19
      selfHeal: true

1
# 添加子模块
2
git submodule add https://github.com/org/repo path/to/repo
3

4
# 更新子模块
5
git submodule update --remote
6

7
# 克隆包含子模块的仓库
8
git clone --recursive https://github.com/org/repo

1
# 工作区暂存
2
git worktree add ../feature-branch feature
3

4
# 查看工作区
5
git worktree list
6

7
# 清理工作区
8
git clean -fd  # 删除未跟踪文件
9
git clean -n  # 预览删除内容

1
# Git 别名配置
2
git config --global alias.st "status -s"
3
git config --global alias.co "checkout"
4
git config --global alias.br "branch"
5
git config --global alias.lg "log --oneline --graph --all"
6

7
# Shell 别名
8
alias gs='git status'
9
alias ga='git add'
10
alias gc='git commit'
11
alias gp='git push'
12
alias gl='git pull'