forked from Gitlink/gitlink-cli
71 lines
1.8 KiB
Markdown
71 lines
1.8 KiB
Markdown
# 分支管理完整工作流
|
||
|
||
本示例演示一个完整的分支管理流程：查看分支 → 创建分支 → 开发推送 → 保护分支 → 清理旧分支。
|
||
|
||
## 场景描述
|
||
|
||
你正在维护一个 GitLink 仓库，需要开发一个新功能。开发完成后需要保护主分支，并清理已完成的功能分支。
|
||
|
||
## 步骤
|
||
|
||
### 1. 查看当前所有分支
|
||
|
||
```bash
|
||
gitlink-cli branch +list
|
||
```
|
||
|
||
输出示例：
|
||
```
|
||
Branch Protected
|
||
master Yes
|
||
develop No
|
||
feature/old-login No
|
||
```
|
||
|
||
### 2. 创建新功能分支
|
||
|
||
```bash
|
||
gitlink-cli branch +create --name feature/new-auth --from develop
|
||
```
|
||
|
||
输出确认分支创建成功。
|
||
|
||
### 3. 本地开发并推送
|
||
|
||
```bash
|
||
git checkout -b feature/new-auth
|
||
# ... 编写代码 ...
|
||
git add .
|
||
git commit -m "feat: add new auth module"
|
||
git push gitlink feature/new-auth
|
||
```
|
||
|
||
### 4. 创建 PR 并合并
|
||
|
||
通过 `gitlink-cli pr +create` 创建 PR，审查后合并。合并后，功能分支 `feature/new-auth` 将自动删除（取决于仓库设置）。
|
||
|
||
### 5. 保护主分支
|
||
|
||
确保 `master` 分支有保护规则，防止误删或直接推送：
|
||
|
||
```bash
|
||
gitlink-cli branch +protect --name master
|
||
```
|
||
|
||
### 6. 清理旧分支（可选）
|
||
|
||
开发完成后，删除不再需要的旧分支：
|
||
|
||
```bash
|
||
# 确认旧分支已合并或无保留价值后
|
||
gitlink-cli branch +delete --name feature/old-login
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
- `branch +delete` 是 **Destructive Operation**，操作前请确认分支内容已合并或无保留价值
|
||
- `branch +protect` 会对分支施加保护规则，影响后续的推送和合并流程
|
||
- `branch +unprotect` 仅支持简单分支名（如 `main`），含 `/` 的路径需通过 Web 页面操作
|
||
- 建议使用 `branch +list` 先查看分支状态，再执行写入/删除操作
|
||
- 建议使用 `branch +list` 先查看分支状态，再执行写入/删除操作
|