使用GitHub/GitLab协作

版本控制基础概念

Git作为分布式版本控制系统，核心在于跟踪文件变化。每个开发者拥有完整的仓库副本，通过提交(commit)记录变更。基本工作流程包括：

# 初始化仓库
git init

# 添加文件到暂存区
git add .

# 提交变更
git commit -m "Initial commit"

典型分支结构包含master/main分支和多个特性分支。冲突解决是协作关键环节：

// 冲突文件示例
<<<<<<< HEAD
const apiUrl = 'https://production.api';
=======
const apiUrl = 'https://staging.api';
>>>>>>> feature/new-api

GitHub协作流程

Pull Request(PR)是GitHub协作的核心机制。完整流程包括：

1. Fork主仓库到个人账户
2. 克隆本地副本：

git clone git@github.com:yourname/repo.git

3. 创建特性分支：

git checkout -b feature/awesome

4. 修改后推送到远程：

git push origin feature/awesome

PR模板示例：

## 变更描述
- 添加用户管理模块
- 修复登录页面样式问题

## 测试步骤
1. 启动开发服务器
2. 访问/user页面
3. 验证CRUD操作

GitLab Merge Request特性

GitLab的Merge Request(MR)提供独特功能：

• 多审核者指派
• 代码质量门禁
• CI/CD流水线集成

.gitlab-ci.yml配置示例：

stages:
  - test
  - deploy

unit_tests:
  stage: test
  script:
    - npm install
    - npm test

production_deploy:
  stage: deploy
  only:
    - master
  script:
    - npm run deploy

分支策略比较

常见分支管理模型对比：

特性分支命名规范示例：

feat/user-auth    # 新功能
fix/login-error   # 问题修复
chore/ci-update   # 维护任务

代码审查最佳实践

高效代码审查要点：

1. 小范围提交（200行以内）
2. 清晰的提交信息：

git commit -m "feat(auth): add OAuth2 support

- Implement Google OAuth provider
- Add token refresh logic
- Update user schema"

3. 使用行内评论：

// TODO: 需要添加输入验证 - @reviewer
function processInput(data) {
  return data.trim();
}

冲突解决技巧

常见冲突场景处理：

1. 二进制文件冲突：选择特定版本

git checkout --ours image.png
git checkout --theirs document.pdf

2. 依赖冲突：使用包管理器解决

{
  "dependencies": {
    "react": "18.2.0",  // 保留当前版本
    "lodash": "^4.17.21" // 接受新版本
  }
}

3. 使用图形化工具：

git mergetool

CI/CD集成

自动化测试与部署配置示例：

GitHub Actions工作流文件：

name: Node.js CI

on: [push, pull_request]

jobs:
  build:
    runs-on: ubuntu-latest
    
    steps:
    - uses: actions/checkout@v3
    - run: npm install
    - run: npm test
    - run: npm run build

GitLab Runner配置：

[[runners]]
  name = "Docker Runner"
  url = "https://gitlab.com/"
  executor = "docker"
  [runners.docker]
    image = "node:16"

项目管理集成

问题跟踪与代码关联：

1. 关闭问题语法：

Fixes #123
Resolves gitlab-org/gitlab#456

2. 里程碑管理：

git tag -a v1.2.0 -m "Release candidate"
git push origin --tags

3. 看板集成示例：

// 自动移动问题卡片
function updateCardStatus(issueId, status) {
  fetch(`/api/issues/${issueId}`, {
    method: 'PATCH',
    body: JSON.stringify({ status })
  });
}

权限管理模型

不同角色的权限配置：

GitHub团队权限示例：

• Read：查看代码
• Triage：管理issue
• Write：推送代码
• Maintain：管理设置

GitLab保护分支设置：

protected_branches:
  - name: master
    push_access_level: maintainer
    merge_access_level: developer
    unprotect_access_level: owner

高级协作技巧

1. 使用git rebase保持历史整洁：

git fetch origin
git rebase origin/main

2. 交互式重置修改：

git rebase -i HEAD~3

3. 子模块管理：

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

4. 大型文件存储：

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