WebStorm 2025.2 Help

与远程 Git 仓库同步(fetch、pull、更新)

在您通过 将更改推送到上游 分享工作成果之前,需要先与远程仓库同步,以确保项目本地副本是最新的。 您可以通过以下方式之一完成此操作: fetch changespull changesupdate your project

Git 分支弹出窗口会指示尚未获取的传入提交数量(蓝色箭头图标 传入提交指示器 显示在分支名称旁边)和传出提交数量(绿色箭头图标 传出提交指示器 显示在分支名称旁边)。

传入提交指示器

获取更改

当您从上游 fetch 更改时,所有自上次与远程仓库同步以来提交的新数据将下载到您的本地副本中。 这些新数据不会集成到您的本地文件中,也不会对您的代码应用更改。

获取的更改会作为远程分支存储,您可以在 merge 到文件之前进行查看。 由于 fetch 不会影响本地开发环境,因此这是获取远程仓库所有更改的安全方式。

有两种方式可以从上游获取更改:

  • 在主菜单中选择 Git | Fetch

  • 或者,打开 分支 弹出窗口,然后单击右上角的 获取图标

    获取图标

观看此视频以更好地了解在 IDE 中如何执行 fetch 操作。

更新分支

如果您需要将某个分支与其远程跟踪分支同步,请使用 update。 这是一个便捷的快捷方式,用于 fetching 并随后将更改应用到所选分支。

  • 分支 弹出窗口或 分支 工具窗口的 版本控制 面板中,选择一个分支并在上下文菜单中选择 更新

WebStorm 将从远程分支 pull 更改,并根据在 设置 | 版本控制 | Git 中选择的更新方法将其 rebasemerge 到本地分支中。

拉取更改

如果您需要将另一个分支的更改拉取到当前分支,而不是拉取其远程跟踪分支的更改,请使用 pull。 当您 pull 时,不仅会下载新数据,还会将其集成到您的本地工作副本中。

  1. 在主菜单中,转到 Git | Pull。 将打开 拉取更改 对话框:

    拉取对话框
  2. 如果您的项目是一个多仓库项目,会显示附加的下拉列表,允许您选择仓库。

  3. 如果项目配置了多个远程仓库,请从列表中选择一个远程仓库(默认是 origin)。

  4. 选择要从中拉取更改的分支,该分支的更改将被拉取到当前检出分支中。 默认选择当前本地分支所跟踪的远程分支。 如果指定了不同的分支,WebStorm 会记住您的选择,并在今后默认显示该分支。

  5. 如果需要带选项地拉取更改,请单击 修改选项 ,然后从以下内容中选择:

    • --rebase :从远程分支 fetching 更改后,WebStorm 会将本地未推送的更改 rebase 到获取的更改上。

    • --ff-only :仅在可以执行 fast-forward 的情况下才解决合并。

    • --no-ff :无论是否可以 fast-forward,都会创建一个合并提交。

    • --squash :将在当前分支顶部创建一个包含所有拉取更改的提交。

    • --no-commit :将执行合并,但不会创建合并提交,以便您在提交前检查合并结果。

    • --no-verify :在跳过默认情况下运行的预合并和提交消息钩子的同时执行合并操作。

    有关 pull 选项的更多信息,请参阅 https://git-scm.com/docs/git-pull

  6. 单击 拉取

更新项目

如果您的项目包含多个项目根目录,或希望每次与远程仓库同步时都从所有分支获取更改,使用 updating 项目可能是更方便的选择。

执行 update 操作时,WebStorm 会从所有项目根和分支 fetches 更改,并将远程跟踪分支 merges 到您的本地工作副本中(相当于 pull)。

  1. 在主菜单中,转到 Git(G) | 更新项目 或按 Ctrl+T。 将打开 更新项目 对话框。

  2. 选择更新类型(该策略将应用于所有受 Git 版本控制的根目录):

    • 将传入的更改合并到当前分支 :选择此选项以在更新期间执行 merge。 这相当于依次运行 git fetchgit merge ,或 git pull --no-rebase

    • 将当前分支变基到传入的更改之上 :选择此选项可在更新期间执行 rebase。 这相当于依次运行 git fetchgit rebase ,或 git pull --rebase (所有本地提交将被置于更新后的上游 HEAD 之上)。

如果您选择将来不再显示 更新项目 对话框,并希望之后修改默认更新策略,可转到 版本控制 | 确认 设置页面 Ctrl+Alt+S ,在 拉取前显示选项 下方选择 更新 ,并在下一次执行更新时修改更新策略。

更新操作完成后,会在 Git 工具窗口中添加 Update Info 选项卡 Alt+9。 该选项卡列出了自上次与远程同步以来的所有提交,并允许您以与 日志选项卡 中相同的方式查看更改。

最后修改日期: 2025年 9月 26日