GoLand 2025.2 Help

代码风格

方案

在该区域中,选择 代码风格方案 ,并根据需要进行更改。 每次 GoLand 生成、重构或重新格式化代码时,都会自动应用代码风格方案设置。

IDE 随附两个预定义方案: 项目 方案和 默认值 方案。

  • 项目 方案中,您配置的设置仅适用于当前项目。

    这些设置存储在 codeStyles 文件夹中,位于 .idea 下,并通过 VCS 与项目一同共享。

    在您修改项目的代码风格设置后,IDE 会创建该文件夹。

  • 默认值 方案(IDE 级别方案)中,您配置的设置将应用于所有选择了 默认值 代码风格方案的现有项目。

    这些设置存储在 GoLand 配置目录 下的 codestyles 文件夹中,不通过 VCS 共享。

如果您希望使用项目代码风格方案作为默认方案,可以将其复制到 IDE 级别。 反过来也可以:您可以用选定的 IDE 级别方案设置覆盖当前项目设置,并与团队其他成员共享。

项目

描述

方案

从此列表中选择要使用的方案。 预定义方案以粗体显示。 以预定义方案为副本创建的 自定义方案以常规字体显示。 方案的存储位置显示在每个方案旁边,例如, 默认值 方案存储在 IDE 中, 项目 方案存储在项目中。

显示方案操作

点击此按钮以打开用于管理方案的命令列表:

  • 复制到IDE… :选择此选项可将方案设置复制到 GoLand。

  • 导出 :选择此选项可将所选方案导出为 IntelliJ IDEA 代码样式 XMLEditorConfig 格式(若启用了 EditorConfig 插件)。

  • 导入方案 :选择此选项可从指定位置导入所选类型的方案。

  • 复制项目 :选择此选项可用所选 IDE 代码风格方案设置覆盖当前项目设置。

  • 复制… :选择此选项可创建所选方案的副本。

  • 重置 :选择此选项可将默认或捆绑的配色方案重置为 GoLand 所附的初始默认值。 只有在进行了某些更改后,此命令才可用。

  • 重命名 :选择此选项可更改所选自定义方案的名称。 按 Enter 保存更改,或按 Escape 取消。

常规

行分隔符

GoLand 允许您为多种语言配置行分隔符与缩进选项。 在 重新格式化源代码时,GoLand 将应用指定的缩进行为,并跳过标记为格式化关闭或开启的部分。

项目

描述

行分隔符

使用此列表指定 GoLand 创建的文件中所使用的 行分隔符。 可用选项包括:

  • 取决于系统 :选择此选项以使用操作系统默认的分隔符。

  • Unix 和 macOS (\n) :选择此选项以使用 Unix 和 macOS 的行分隔符。

  • Windows (\r\n) :选择此选项以使用 Windows 的行分隔符。

  • Classic Mac OS (\r) :选择此选项以使用 \r 行分隔符,该分隔符用于 经典 Mac OS (至 Mac OS 9)。

强制换行位置

在此字段中,指定用于在编辑器中显示页面的列数。

键入时换行

选中此复选框可确保编辑文本始终适配所设定的右边距。

视觉参考线

在此字段中可指定多个右边距。 您可以保留默认值,或输入用于设置边距的空格数。 如果要设置多个边距,请输入用逗号分隔的数字。

缩进检测

选择 检测并使用现有的文件缩进进行编辑 以检测当前文件中的 缩进样式 ,并使用该样式替代在特定语言 Code Style 设置中指定的缩进。

GoLand 在编辑器的状态栏中显示缩进信息。 您可以单击缩进信息以查看可用操作,例如启用或禁用此选项,以及将当前缩进更改为特定语言的 Code Style 设置中指定的缩进。

EditorConfig

选中 启用EditorConfig 支持 复选框以使用 EditorConfig 设置代码样式。 在这种情况下,您可以指定覆盖 IDE 设置的代码样式设置,并在项目中使用不同的代码样式。

如果创建了 EditorConfig 设置文件后决定使用 IDE 设置,则需要清除 启用EditorConfig 支持 复选框。

格式化器

在此区域中,指定用于限制要从 重新格式化 中排除的代码片段的标记。 在源代码中,格式化标记写在 行注释 中。

项目

描述

不设置格式

不设置格式 字段中,指定一个 glob 模式 ,列出想要从 重新格式化代码排列导入优化 中排除的文件和目录名称,例如: *.{html,htm}

您可以使用分号 分隔多个 glob 模式。

使用星号 * 通配符可完全禁用重新格式化。

在代码注释中使用标记打开/关闭格式化程序

  • 如果启用此选项,带有格式化标记的行注释之间的代码片段将根据这些标记重新格式化:带有开启标记的代码片段将被重新格式化,带有关闭标记的代码片段在重新格式化后将保持不变。 请参阅 使用格式化标记的示例

    选择此复选框后,下方的字段将变为可用,您可以将指定的字符串视为格式化标记。

  • 如果禁用此选项,则格式化标记将被忽略,带有标记的行注释之间的代码将被重新格式化。

关:

在此字段中,指定用于表示想要从重新格式化中排除的代码片段起始位置的字符串。 键入包含 @ 符号的字符串或保留预定义值 @formatter:off

开:

在此字段中,指定用于表示想要从重新格式化中排除的代码片段结束位置的字符串。 键入包含 @ 符号的字符串或保留预定义值 @formatter:on

在格式化程序标记中启用正则表达式

选中此复选框以使用正则表达式,而不是显式指定格式化标记。 GoLand 会使用指定的正则表达式匹配格式化启用/禁用标记,而不是精确字符串。

例如,使用正则表达式可以为启用和禁用格式化器定义多个标记。 在这种情况下,您可以使用以下正则表达式: @formatter:(off|disable|no)@formatter:(on|enable|yes)

有关演示,请参阅 使用格式化标记的示例

使用格式化标记的示例

该示例显示两个代码片段。 其中一个使用 @formatter :off@formatter:on 标记包裹,另一个则未使用。

格式化标记

原始格式已保留:

格式化标记已关闭

原始格式未保留:

格式化标记已关闭
最后修改日期: 2025年 9月 26日