WebStorm 2026.3 Help

派生 GitHub 项目

如果您想为托管在 GitHub 上且不能直接 push 的项目做贡献,请遵循以下工作流程:

  1. 创建项目的一个 fork ,然后开始贡献。

  2. Clone 这个 fork 以创建一个本地仓库。

  3. 请对您原始项目的副本进行修改, commit 并 push 这些更改。

  4. 当您准备好分享您的工作成果时,请运行 Sync Fork以将您的 fork 重定基于原项目主分支的当前 HEAD。 这有助于确保您的更改不会与您创建 fork 后推送的新的提交发生冲突。

  5. 向原项目提出 创建 pull request 来建议您的更改。

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

复刻项目

一个 fork 是您的 GitHub 仓库副本,使您可以更改代码而不影响原始项目。

创建一个 fork

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

将在您的帐户下创建原始项目的副本。 如需对该项目进行更改,您需要将其 clone以创建一个本地仓库。

将复刻与原始项目同步

  • 在主菜单中,进入 Git|GitHub|同步分叉. 该复刻将变基到其来源原始项目的 main 分支上的 HEAD 提交。

如果 Sync Fork 未完成

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

  • 不支持多仓库项目。

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

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

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

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

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

2026年 11月 6日