跳转至

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

在你开始修改之前,请确保你已经创建了一个分支。默认情况下,当你克隆你的版本库分叉时,你将在 "主 "分支上签出。这是 BeeWare 的 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