跳转至

请在功能分支上工作,而非你的main分支

在你开始修改内容以前,请务必确保你已创建了一个新的分支。当你克隆你的派生 (fork) 版本库时,你将会默认在 main 分支上,即为 BeeWare 的 main 分支的直接副本。

虽然你可以从你的 main 分支提交拉取请求,但这不是最佳方法。如果你提交的拉取请求基本正确,那么审查你的拉取请求的核心团队成员将会直接在你的拉取请求上做出所需的更改,而不会给出反馈以要求你做细微的改动。但是,如果你从你的 main 分支提交拉取请求,审核人员将无法进行直接修改。

在 main 分支上工作也会给自己完成第一个拉取请求后时带来困难。如果你想贡献第二个拉取请求,你需要有一份上游项目 main 分支的“干净”版本为基础;如果你已经从你的 main 分支做了第一次贡献,你也就不会有另一个干净的版本可用了。

相反,你应该在功能分支上进行修改。功能分支有简单的名称,用来辨别你将会做的更改。例如,如果你要修复一个会导致 Windows 11 上构建问题的错误,您可以创建一个名为 fix-win11-build 的功能分支。如果你修复的问题与已报告的特定工单有关,在分支名称中引用该工单编号也很常见(例如,fix-1234)。

要创建 fix-win11-build 功能分支,运行:

(.venv) $ git switch -c fix-win11-build
(.venv) $ git switch -c fix-win11-build
(.venv) C:\...>git switch -c fix-win11-build