GoLand 2026.2 Help

Git

使用此页面指定将应用于受 Git 控制的项目目录的版本控制设置。

Git 可执行文件路径

在此字段中,指定 Git 可执行文件的路径。 请键入路径或点击 浏览 “浏览”按钮 并在打开的对话框中指定路径。

GoLand 支持来自 Linux 子系统 2 (WSL2) 的 Git,适用于 Windows 10 版本 2004。

如果 Windows 上未安装 Git,GoLand 将在 WSL 中搜索 Git 并从那里使用它。 此外,当您使用 \\wsl$ 路径时,GoLand 会自动切换到从 WSL 打开的项目的 Git。

Windows 上对 WSL2 的 Git 支持

测试

点击此按钮以验证 Git 可执行文件的路径。

提交

启用暂存区

如果您更习惯于在提交前通过 staging更改而不是使用 changelists (此方法会自动暂存修改的文件),请启用此选项。

使用暂存区可以让您轻松地将对同一文件的更改单独提交(包括重叠的更改),并无需从编辑器切换焦点即可查看哪些更改已经暂存。 欲了解更多信息,请参阅 使用 Git 暂存区提交更改。

如果即将提交 CRLF 行分隔符,请警告

选择此选项以启用对 LF 和 CRLF 行分隔符的智能处理。 GoLand 将分析您的配置,在您即将提交 CRLF 到仓库时发出警告,并根据您的操作系统建议将 core.autocrlf 设置更改为 true 或 input。

如果取消选择此选项,您将不得不使用 差异查看器对话框 手动修复行尾问题。

在分离的 HEAD 状态或变基期间提交时警告

选择此选项,如果您希望 GoLand 在从脱离的 head 或进行 rebase 时执行提交操作时显示警告,因为这可能会导致问题和代码丢失。

在挑选推送到受保护分支的提交时添加“cherry-picked from <hash>”后缀

如果您希望在从 protected branch进行cherry-picking时保留对原始commit的引用,请选择此选项。 默认情况下,摘樱桃操作不会添加后缀。

配置 GPG 密钥

点击以配置 GPG Key 来签署您的提交或选择现有的密钥。 欲了解更多信息,请参阅 使用 GPG 密钥签署提交。

推送

如果当前分支的推送被拒绝,则自动更新

如果当前分支到其跟踪分支的 push 操作被拒绝,选择此复选框以自动更新当前分支。

如果取消选择此选项,当您的本地存储库与远程存储不同步而导致 推送分支被拒绝时,GoLand 将显示 推送被拒 对话框。

请注意以下几点:

  • 如果您以前从未见过 推送被拒 对话框,并且您是第一次启用复选框,GoLand将通过 merge 操作静默更新冲突的本地分支。

  • 如果您已经遇到 推送被拒 对话框并选择 请记住更新方法的选择... 选项,GoLand会保存您的上次选择 rebase 或 merge ,并会将其应用于静默更新冲突的本地分支。

    因此,要更改“记住”的设置,请取消选中复选框,访问 推送被拒 对话框,选择 如果推送……被拒绝,自动更新 选项,然后调用另一个更新策略。

显示提交和推送的推送对话框

如果您希望在 提交更改 对话框中点击 提交并推送 后显示 推送对话框 ,请选择此选项。 否则,您的更改将自动推送到受影响的代码库。

仅在提交到受保护分支时显示推送对话框

如果您只希望在将更改推送到受保护的分支时,才在 提交更改 对话框中点击 提交并推送 后显示 推送更改 对话框,请选择此选项。 否则,您的更改将自动推送到受影响的代码库。

受保护的分支

如果您希望禁用对某些分支 强制提交更改的功能,请在此列出它们(这是存储在 .idea/vcs.xml 中的团队共享参数)。

您可以列出多个分支并用分号分隔,或者提供分支模式,因为输入被视为正则表达式列表。

从 GitHub 加载分支保护规则

如果您想向 GoLand 添加 GitHub 保护规则并在每次获取时同步它们,请选择此选项。

更新

更新方法

请使用此列表选择同步本地仓库与远程存储的策略。 选定的方法将在 push 操作被拒绝时使用(如果启用了 当前分支推送被拒绝时自动更新选项),或者在您调用 更新项目 操作时使用。 提供以下选项:

  • 合并 :选择此选项以在更新期间执行 合并。 这相当于先运行 git fetch ,然后运行 git merge ,或 git pull --no-rebase。

  • 变基 :选择此选项以在更新期间执行 rebase。 这相当于运行 git fetch 然后 git rebase ,或者 git pull --rebase (所有本地提交将会被放置在更新后的上游头部之上)。

使用 清理 工作树

选择在执行项目更新时如何处理未提交的更改:

  • 储藏 :本地更改将保存到一个 git stash。 如果您需要在 GoLand 之外应用带有暂存更改的补丁,这会很有用,因为它们是由 Git 自行生成的。

  • 搁置 :GoLand 将把本地更改放置到 搁置。 搁置由 GoLand 完成,从搁置的更改生成的补丁通常应用在 GoLand 内。

按路径筛选"更新项目"信息。

如果您不希望在执行 更新时在 Update Info标签中获得有关项目所有更改的信息,您可以通过指定路径筛选列表。

自动提取远程更改

每隔 20 分钟启用后台获取远程更新。 使用此功能可跟踪传入的更改。

该时间间隔可通过 git.update.incoming.info.time 注册表项进行配置。

检查远程是否有传入更改

启用此选项后,GoLand 将检查是否有尚未获取到本地仓库的待处理传入提交,并会在 VCS 微件中标记此类分支。

提取标记

指定从远程获取时 GoLand 应如何处理标记:

  • 自动 :遵循 Git 配置中定义的默认行为。

  • 同步 (--prune-tags ):从远程获取所有标记,并删除本地已不存在于远程仓库中的标记。

  • 始终 (--tags ):强制从远程获取所有标记。

  • 从不 (--no-tags ):完全禁用标记获取。

使用凭据助手

如果您不想覆盖 credential helpers ,请选择此选项,这是默认行为。 您将能够在 Git 登录 对话框中使用凭证助手进行身份验证。

储藏

在一个选项卡中合并暂存和搁置

如果您希望在 提交 工具窗口 Alt+0 中的 储藏和搁置 标签下同时查看 暂存 和 搁置 的更改,请启用此选项。

调用“显示差异”时,比较储藏的更改

在本节中,指定在调查储藏更改时希望在差异查看器中看到的内容。

  • 与文件的本地版本 :储藏的更改与所选文件的本地版本进行比较。 此选项默认已启用。

  • 与父提交 :储藏的更改与父提交进行比较。

2026年 7月 14日