GoLand 2025.2 Help

提交更改对话框

使用此对话框可将本地更改 提交(签入)到版本库,并可选择创建补丁文件。

此对话框中可用的选项取决于您使用的版本控制系统。

已修改文件窗格

本节列出自上次提交以来已修改的所有文件。 取消选中您想要从当前提交中排除的文件旁的复选框。

已修改文件窗格工具栏

项目

工具提示和快捷键

描述

显示差异按钮

显示差异

Ctrl+D

打开 差异对话框,突出显示所选文件的本地工作副本与其版本库版本之间的差异。

还原图标

还原

还原所选文件本地工作副本中所做的所有更改。

刷新按钮

刷新更改

Ctrl+F5

单击此按钮以重新加载 已更改文件 树视图,使其保持最新。

分组依据按钮

分组依据

选择如何对已修改的文件进行分组——按目录或模块

全部展开按钮

全部折叠按钮

展开或折叠所有节点

Ctrl+NumPad +

Ctrl+NumPad -

单击这些按钮可展开或折叠目录树中的所有节点。 平铺视图中不提供这些按钮。

更改列表

不适用

从此列表中选择包含要签入或包含在补丁中的已修改文件的更改列表。 默认选中活动的更改列表。

修改文件窗格下方的摘要显示当前选中更改列表的统计信息,例如已修改、新增、删除和未加版本控制的文件数。 此区域还会显示各类型文件的显示数量以及将要提交的数量。

提交消息窗格

在此区域中,为当前提交输入注释。 在 提交信息 字段中输入说明之前,无法提交更改。

如果决定创建补丁,此注释也将用作补丁文件名。

您可以单击 提交信息历史记录 提交消息历史记录 Ctrl+M 从最近的提交消息列表中进行选择。

特定于 VCS 的控件

此部分中的控件位于对话框的右上角,包含与您所用版本控制系统相关的选项。

项目

描述

作者

使用此列表选择您将要提交的更改的作者。 当您提交其他人所做的更改时,此功能可能很有用。

修补提交

Select this checkbox to replace the previous commit with the current changes. 有关更多信息,请参阅 Git 基础:撤销操作

签署提交

选中此项可签署您的提交,以声明即将签入的更改是由您本人完成,或您对所提交代码承担责任。

启用此选项后,以下内容将自动添加到提交消息的末尾: Signed off by: <username>

描述

修改提交

Select this checkbox to replace the previous commit with the current changes. 如需了解更多信息,请参阅 Git Basics: Undoing Things

描述

保持文件锁定

选中此复选框,在提交更改后保留文件 锁定

描述

作业

仅当您在 Perforce 设置页面上选中 启用 Perforce 工作项支持 复选框时,此区域才可用。

使用此区域中的控件搜索 Perforce 作业 、将作业链接到所选更改列表并取消当前已链接的作业。

  • 移除按钮取消关联所选工作项 :单击此按钮可将所选作业从更改列表中取消链接。

  • 编辑关联作业按钮编辑关联的工作项 :单击此按钮以打开 编辑链接到更改列表的作业 对话框,在其中可搜索可用作业、查看其详细信息,并将作业链接到所选更改列表。

  • 添加按钮查找并关联匹配模式的工作项 :单击此按钮以根据字段中指定的模式快速搜索匹配的作业,并将其附加到更改列表中。

    在字段中,根据 Perforce 作业的 语法规则 指定作业的确切名称或搜索模式。

此区域底部的列表显示当前附加到所选更改列表的作业。

提交检查

使用此区域中的控件定义在提交所选文件时,您希望 GoLand 执行哪些附加操作。

以下版本控制系统支持这些控件:

  • Git

  • Subversion

  • Perforce

描述

重新格式化代码

根据 项目代码样式设置 执行代码格式化。

重新排列代码

根据 排列规则首选项 重新排列代码。

优化导入

移除冗余的 import 语句。

清理

自动对您准备提交/暂存的文件应用当前检查配置文件。

更新版权声明

根据所选版权配置文件与作用域的组合 添加或更新版权声明

Go fmt

使用 go fmt 格式化代码。 如需了解有关 Go 工具的更多信息,请参阅 Go 工具

高级提交检查

使用此区域中的控件定义在提交所选文件后,您希望 GoLand 执行哪些附加操作。

描述

分析代码

Analyze modified files while committing them. 单击 配置 可选择一个 检查配置文件 ,IDE 将基于该配置文件运行检查。

检查 TODO(<filter name>)

检查符合指定筛选条件的 TODO 项。 单击 配置 选择 已有的 TODO 筛选器 ,或打开 TODO 设置页面 来定义要应用的新筛选器。

运行工具

在此列表中,选择您希望在提交所选更改后由 GoLand 启动的 外部工具。 您可以在列表中选择一个工具,也可以单击 浏览 按钮 浏览按钮 ,并在打开的 外部工具 对话框中进行配置。

提交完成后运行高级检查

启用在提交更改后运行高级检查。 即使某些检查失败,您的更改也仍会被提交。

差异窗格

要打开 差异 面板,请按 Ctrl+D ,或右键单击要检查的文件,在上下文菜单中选择 显示差异

在此面板中,您可以比较所选文件的基础版本库版本与准备提交的当前版本之间的差异。

差异窗格工具栏

工具提示和快捷键

描述

上一个差异按钮/下一个差异按钮

上一个差异/下一个差异 Shift+F7 F7

跳转到上一个或下一个差异。

When the last or the first difference is reached, GoLand suggests clicking the arrow buttons or pressing F7/Shift+F7 once more and comparing other files modified locally. 此行为取决于 到达最后一个更改后跳转到下一个文件 选项是否在 差异查看器设置 中启用。

跳转到源按钮

跳转到源(J)

F4

在编辑器中打开所选文件。 光标将定位在与 差异查看器 中相同的位置。

后退

前进

比较上一个/下一个文件

Alt+Left Alt+Right

单击这些按钮以将上一个/下一个文件的本地副本与来自服务器的更新版本进行比较。

查看器

选择查看器模式:并排或统一。并排模式包含两个面板,统一模式包含一个面板。 并排模式包含两个面板,统一模式包含一个面板。

您可以在两个查看器中编辑代码并执行 接受追加还原 操作。

您只能在并排查看器的右侧部分或统一查看器中的下方行编辑文本。

您只能编辑文件的本地版本。 您无法编辑只读状态的文件。

空格

定义差异查看器如何处理空格。

  • 不忽略 :空格重要,所有差异将被高亮显示。 此选项为默认选中项。

  • 修整空白 :如果空格位于行首或行尾,则进行裁剪(("\t", " "))。

    • 如果两行仅在结尾空格上有所不同,则视为相同。

    • 如果两行不同,在 按词 模式下,结尾空格不会被高亮显示。

  • 忽略空格 :空格不重要,无论其在源代码中的位置如何。

  • 忽略空格和空行 :忽略空格和空行。 以下实体将被忽略:

    • 所有空格(同“忽略空格”选项)

    • 所有仅由空格组成的新增或删除行

    • 所有仅涉及断行或合并、未更改非空格部分的更改。

      例如, a b ca \n b c 之间的差异在此模式下不会高亮显示。

高亮模式

选择差异粒度的高亮方式。

可用选项如下:

  • 高亮显示单词 :高亮显示修改的单词

  • 高亮显示行 :高亮显示修改的行

  • 高亮显示拆分的更改 :选择此选项时,大的更改将被拆分为小的更改。

    例如,将 A \n BA X \n B X 视为两个更改而非一个。

  • 高亮显示字符 :高亮显示修改的符号

  • 不高亮显示 :选择此选项时,所有差异将不会被高亮显示。

    处理已大幅修改的文件时,请使用 不高亮显示 选项。 在此类情况下,高亮可能会为审核带来额外困难。

折叠未更改片段图标

收起未更改的片段

折叠两个文件中所有未更改的片段。 不可折叠的未更改行数可在 差异与合并 设置页面进行配置。 如需打开 差异与合并 页面,请通过按 Ctrl+Alt+S 打开设置并导航到 工具 | 差异与合并。 。

同步滚动

同步滚动

同时滚动两个差异面板。 如果此按钮未按下,每个面板可以独立滚动。

禁用编辑图标

禁用编辑

启用对所选文件本地副本的编辑,默认情况下编辑是禁用的。 启用编辑后,您可以在提交前对已修改的文件进行最终更改。

齿轮图标

编辑器设置

打开可用选项列表。 选择或取消选择这些选项以显示或隐藏行号、缩进引导线、空格和软换行。

帮助图标

帮助

F1

打开浏览器并显示相应的帮助页面。

请注意,以上大多数选项仅适用于文本文件。 二进制文件的差异选项数量有限。

提交/提交按钮

点击此按钮以提交所选文件,或将鼠标悬停在该按钮上以显示以下可用的提交选项之一:

  • 提交并推送 :选择此选项可在提交更改后立即将其推送到远程版本库。 当您使用版本控制系统 GitMercurial 时,此选项可用。

  • 创建 MQ 补丁 :选择此选项可基于您的更改创建 MQ 补丁。 仅当您使用 Mercurial 作为版本控制系统时,此选项可用。

  • 创建补丁 :如果希望 GoLand 根据您即将提交的更改生成补丁,请选择此选项。 在打开的 创建补丁 对话框中,输入补丁文件的名称并指定是否需要反向补丁。

  • 远程运行 :选择此选项以 运行您的个人构建。 此选项仅在您登录到 TeamCity 时可用。 如需了解更多信息,请参阅 TeamCity 插件文档

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