PyCharm 2026.3 Help

派生 GitHub 项目

如果您想为托管在 GitHub 上且无法直接推送的项目做出贡献,请按照以下工作流程操作:

  1. 创建派生 ,用于您想要贡献的项目。

  2. 克隆 此派生以创建本地存储库。

  3. 对原始项目的副本进行更改,并将其 提交 并 推送。

  4. 当您准备共享您的工作成果时,运行 同步派生 ,将您的派生变基到原始项目的 main 分支当前的 HEAD 上。 需要执行此操作以确保您的更改不会与在您创建派生之后推送的新提交发生冲突。

  5. 创建拉取请求 ,以向原始项目建议您的更改。

  6. 在本地 显示并应用 建议。

派生项目

派生 是某个 GitHub 存储库的副本,使您可以更改代码而不影响原始项目。

创建派生

  • 在 GitHub 上打开要复刻的项目,然后点击 派生图标。

原始项目的副本将创建在您的帐户下。 要更改此项目,您需要将其 克隆 以创建本地存储库。

将复刻与原始项目同步

  • 在主菜单中,转到 Git | GitHub | 同步派生。 复刻将变基到创建该复刻的原始项目的 main 分支中的 HEAD 提交上。

如果“同步复刻”未完成

如果同步未完成,请检查本地仓库的远程仓库,并注意:

  • 不支持多仓库项目。

  • PyCharm 将 origin 远程仓库视为指向复刻的远程仓库。 如果没有这样的远程仓库,或者它未指向 GitHub 复刻,PyCharm 会显示相应的消息。

  • 为了读取原始项目的 URL 和默认分支,PyCharm 会使用为 origin 服务器注册的 GitHub 账户。 如果有多个这样的账户,它会要求选择一个。

  • PyCharm 会为原始项目添加一个名为 upstream 的远程仓库,或者复用已指向该项目的现有远程仓库,获取该远程仓库,并将当前分支变基到默认分支上。 如果仓库已具有一个 URL 不同的 upstream 远程仓库,PyCharm 会显示错误消息。

  • upstream URL 使用 HTTPS;如果在 设置 | 版本控制 | GitHub 中启用了 使用 SSH 克隆 Git 存储库 ,则使用 SSH。

观看此视频教程,了解如何使您的项目派生保持最新:

2026年 11月 3日