项目版本git

Git分支管理策略，最佳实践建议。

### 建议的分支管理策略

1. **标准分支结构**
```text
# 长期分支
master # 生产环境分支
develop # 开发主分支

# 临时分支
feature/* # 特性分支
release/* # 发布分支
hotfix/* # 紧急修复分支
bugfix/* # 问题修复分支
```

2. **分支命名规范**
```text
# 特性分支
feature/feature-name-date
例：feature/user-auth-20240315

# 发布分支
release/vX.Y.Z
例：release/v3.1.0

# 修复分支
hotfix/issue-number-brief
例：hotfix/issue-123-login-fix

bugfix/issue-number-brief
例：bugfix/issue-456-cache-fix
```

3. **版本号管理规范（语义化版本）**
```text
X.Y.Z 格式说明：
X: 主版本号 - 不兼容的API修改
Y: 次版本号 - 向下兼容的功能性新增
Z: 修订号 - 向下兼容的问题修复
```

### 工作流程示例

```bash
# 1. 开始新特性开发
git checkout develop
git checkout -b feature/user-auth-20240315

# 2. 特性开发完成，合并到develop
git checkout develop
git merge --no-ff feature/user-auth-20240315

# 3. 准备发布
git checkout -b release/v3.1.0 develop

# 4. 发布分支修复问题
git checkout -b bugfix/issue-789-config-fix release/v3.1.0

# 5. 完成发布
git checkout master
git merge --no-ff release/v3.1.0
git tag -a v3.1.0 -m "Release version 3.1.0"

# 6. 紧急修复
git checkout -b hotfix/issue-999-security master
```

### 自动化工具建议

1. **Git钩子配置**
```bash
# .git/hooks/pre-commit
#!/bin/sh

# 检查分支命名规范
branch_name=$(git symbolic-ref --short HEAD)
branch_pattern="^(feature|release|hotfix|bugfix)/[a-z0-9-]+$"

if ! [[ $branch_name =~ $branch_pattern ]]; then
echo "错误: 分支名不符合规范"
echo "正确格式: feature/feature-name-date"
exit 1
fi
```

2. **版本发布脚本**
```python
# release.py
def create_release_branch(version):
"""创建发布分支"""
if not re.match(r'^v\d+\.\d+\.\d+$', version):
raise ValueError("版本号格式错误")

subprocess.run(['git', 'checkout', '-b', f'release/{version}', 'develop'])
subprocess.run(['git', 'push', '-u', 'origin', f'release/{version}'])

def finish_release(version):
"""完成发布"""
subprocess.run(['git', 'checkout', 'master'])
subprocess.run(['git', 'merge', '--no-ff', f'release/{version}'])
subprocess.run(['git', 'tag', '-a', version, '-m', f'Release {version}'])
```

### 建议的改进方案

1. **重命名现有分支**
```bash
# 规范化分支名
git branch -m release/relase3.1.1 release/v3.1.1
git branch -m feature/Feature_3.1.1 feature/feature-3.1.1
```

2. **版本号管理**
```text
建议的版本演进：
v2.0.0 -> v2.1.0 -> v2.2.0 -> v3.0.0 -> v3.1.0 -> v3.1.1
```

3. **分支策略文档**
```markdown
# 分支管理规范

## 分支类型
- master: 生产环境代码
- develop: 开发主分支
- feature/*: 特性开发分支
- release/*: 版本发布分支
- hotfix/*: 紧急修复分支
- bugfix/*: 问题修复分支

## 命名规范
- 使用小写字母
- 使用连字符(-)分隔
- 包含日期或问题编号
```

这样的分支管理策略可以帮助团队更好地协作，保持代码库的整洁和可维护性。建议团队讨论并制定详细的分支管理规范文档，确保所有成员遵循统一的标准。