# Git 仓库分支管理指南

## 一、查看仓库分支

### 1. 命令行方式
```bash
# 查看本地所有分支
git branch

# 查看远程所有分支
git branch -r

# 查看本地和远程所有分支
git branch -a

# 查看分支详细信息（含最后提交）
git branch -v
```

### 2. GitHub 平台操作
- 进入仓库主页
- 点击左上角的分支下拉菜单（默认显示 `main` 或 `master`）
- 查看所有分支列表
- 或访问：`仓库页面 → Branches` 标签

### 3. GitLab 平台操作
- 进入项目主页
- 左侧菜单选择 `Repository → Branches`
- 查看所有分支及详情

## 二、新增分支

### 1. 命令行方式
```bash
# 创建新分支（停留在当前分支）
git branch <新分支名>

# 创建并切换到新分支
git checkout -b <新分支名>
# 或使用新命令
git switch -c <新分支名>

# 基于指定分支创建新分支
git checkout -b <新分支名> <基准分支名>

# 推送新分支到远程
git push -u origin <新分支名>
```

### 2. GitHub 操作
**方法一：通过界面**
- 进入仓库主页
- 点击分支下拉菜单
- 在搜索框输入新分支名
- 点击 `Create branch: <新分支名>`

**方法二：通过文件编辑**
- 选择任意文件点击编辑
- 在提交时选择 `Create a new branch`

### 3. GitLab 操作
- `Repository → Branches`
- 点击右上角 `New branch` 按钮
- 输入分支名称
- 选择基准分支
- 点击 `Create branch`

## 三、修改默认分支

### 1. GitHub 操作
1. 进入仓库主页
2. 点击 `Settings`（设置）
3. 左侧菜单选择 `Branches`
4. 在 `Default branch` 区域点击切换图标
5. 选择新的默认分支
6. 点击 `Update` 确认
7. 在弹出窗口中再次确认 `I understand, update the default branch`

### 2. GitLab 操作
1. 进入项目主页
2. 左侧菜单：`Settings → Repository`
3. 展开 `Default Branch` 部分
4. 从下拉菜单选择新的默认分支
5. 点击 `Save changes`

### 3. 命令行方式（修改远程HEAD）
```bash
# 修改远程仓库的默认分支指向（需要仓库管理权限）
git remote set-head origin <新默认分支名>

# 查看远程默认分支
git remote show origin
```

## 四、最佳实践建议

### 分支命名规范
- `main/master`：主分支
- `develop`：开发分支
- `feature/功能名`：功能分支
- `hotfix/问题描述`：紧急修复分支
- `release/版本号`：发布分支

### 注意事项
1. **修改默认分支前**：确保新分支代码稳定
2. **保护重要分支**：在设置中启用分支保护规则
3. **通知团队**：修改默认分支需提前告知协作者
4. **更新本地仓库**：
   ```bash
   git fetch origin
   git checkout <新默认分支>
   git pull
   ```

### 删除分支
```bash
# 删除本地分支
git branch -d <分支名>

# 强制删除本地分支
git branch -D <分支名>

# 删除远程分支
git push origin --delete <分支名>
```

## 五、常见问题

**Q: 为什么看不到远程新分支？**
```bash
# 先更新远程分支信息
git fetch origin
```

**Q: 修改默认分支后本地怎么处理？**
```bash
git remote set-head origin -a
git branch --set-upstream-to=origin/<新默认分支>
```

**Q: 如何恢复误删的分支？**
```bash
# 查找提交记录
git reflog
# 恢复分支
git checkout -b <分支名> <commit-id>
```

# Git 仓库分支管理指南

## 一、查看仓库分支

### 1. 命令行方式
```bash
# 查看本地所有分支
git branch

# 查看远程所有分支
git branch -r

# 查看本地和远程所有分支
git branch -a

# 查看分支详细信息（含最后提交）
git branch -v
```

### 2. GitHub 平台操作
- 进入仓库主页
- 点击左上角的分支下拉菜单（默认显示 `main` 或 `master`）
- 查看所有分支列表
- 或访问：`仓库页面 → Branches` 标签

### 3. GitLab 平台操作
- 进入项目主页
- 左侧菜单选择 `Repository → Branches`
- 查看所有分支及详情

## 二、新增分支

### 1. 命令行方式
```bash
# 创建新分支（停留在当前分支）
git branch <新分支名>

# 创建并切换到新分支
git checkout -b <新分支名>
# 或使用新命令
git switch -c <新分支名>

# 基于指定分支创建新分支
git checkout -b <新分支名> <基准分支名>

# 推送新分支到远程
git push -u origin <新分支名>
```

### 2. GitHub 操作
**方法一：通过界面**
- 进入仓库主页
- 点击分支下拉菜单
- 在搜索框输入新分支名
- 点击 `Create branch: <新分支名>`

**方法二：通过文件编辑**
- 选择任意文件点击编辑
- 在提交时选择 `Create a new branch`

### 3. GitLab 操作
- `Repository → Branches`
- 点击右上角 `New branch` 按钮
- 输入分支名称
- 选择基准分支
- 点击 `Create branch`

## 三、修改默认分支

### 1. GitHub 操作
1. 进入仓库主页
2. 点击 `Settings`（设置）
3. 左侧菜单选择 `Branches`
4. 在 `Default branch` 区域点击切换图标
5. 选择新的默认分支
6. 点击 `Update` 确认
7. 在弹出窗口中再次确认 `I understand, update the default branch`

### 2. GitLab 操作
1. 进入项目主页
2. 左侧菜单：`Settings → Repository`
3. 展开 `Default Branch` 部分
4. 从下拉菜单选择新的默认分支
5. 点击 `Save changes`

### 3. 命令行方式（修改远程HEAD）
```bash
# 修改远程仓库的默认分支指向（需要仓库管理权限）
git remote set-head origin <新默认分支名>

# 查看远程默认分支
git remote show origin
```

## 四、最佳实践建议

### 分支命名规范
- `main/master`：主分支
- `develop`：开发分支
- `feature/功能名`：功能分支
- `hotfix/问题描述`：紧急修复分支
- `release/版本号`：发布分支

### 注意事项
1. **修改默认分支前**：确保新分支代码稳定
2. **保护重要分支**：在设置中启用分支保护规则
3. **通知团队**：修改默认分支需提前告知协作者
4. **更新本地仓库**：
   ```bash
   git fetch origin
   git checkout <新默认分支>
   git pull
   ```

### 删除分支
```bash
# 删除本地分支
git branch -d <分支名>

# 强制删除本地分支
git branch -D <分支名>

# 删除远程分支
git push origin --delete <分支名>
```

## 五、常见问题

**Q: 为什么看不到远程新分支？**
```bash
# 先更新远程分支信息
git fetch origin
```

**Q: 修改默认分支后本地怎么处理？**
```bash
git remote set-head origin -a
git branch --set-upstream-to=origin/<新默认分支>
```

**Q: 如何恢复误删的分支？**
```bash
# 查找提交记录
git reflog
# 恢复分支
git checkout -b <分支名> <commit-id>
```