STUMPY项目贡献指南：如何同步主分支到开发分支

在参与STUMPY这类开源项目贡献时，开发者经常会遇到需要将主分支(main)的最新变更同步到自己的开发分支的情况。本文将详细介绍这一过程的完整操作流程，帮助贡献者高效管理代码分支。

准备工作

在开始同步操作前，请确保已完成以下准备工作：

1. 已正确fork项目到自己的GitHub账户
2. 已将上游仓库添加为远程仓库(通常命名为upstream)
3. 本地已克隆自己的fork仓库

同步主分支到开发分支的完整步骤

第一步：切换到开发分支

首先进入项目目录并切换到你的开发分支：

cd /path/to/your/local/repo
git checkout your_feature_branch

第二步：提交当前变更

在合并前，建议先提交开发分支上的所有变更：

git add .
git commit -m "保存当前工作进度"

第三步：获取上游变更

从上游仓库获取最新的分支和提交信息：

git fetch upstream

第四步：更新本地主分支

切换到本地主分支并合并上游主分支的变更：

git checkout main
git merge upstream/main

此操作会将你的本地主分支与上游仓库同步。如果本地主分支没有独特提交，Git会执行快速前进(fast-forward)合并；否则可能需要解决冲突。

第五步：合并到开发分支

切换回开发分支并将主分支的变更合并进来：

git checkout your_feature_branch
git merge main

处理合并冲突

在执行最后一步合并时，可能会遇到文件冲突，Git会提示类似以下信息：

Auto-merging some_file.py
CONFLICT (content): Merge conflict in some_file.py
Automatic merge failed; fix conflicts and then commit the result.

此时需要：

1. 打开冲突文件，查找<<<<<<<、=======和>>>>>>>标记
2. 手动解决冲突内容，保留需要的代码
3. 删除冲突标记
4. 保存文件

解决完所有冲突后，提交变更：

git add resolved_file.py
git commit -m "解决合并冲突"

最佳实践建议

1. 频繁同步：建议定期从主分支同步变更，避免积累大量冲突
2. 保持分支专注：每个开发分支应只关注一个特定功能或修复
3. 使用rebase替代merge：对于个人开发分支，可以考虑使用git rebase main来保持提交历史线性
4. 测试后再推送：解决冲突后，确保运行测试后再推送变更

通过遵循这些步骤和建议，开发者可以更高效地管理STUMPY项目的贡献流程，确保代码始终基于最新的代码库进行开发。