GoLand 2025.2 Help

代码样式

如果公司有某些编码规范，那么在编写源代码时必须遵循这些规范。GoLand 可帮助您保持所需的代码样式。 GoLand 可帮助您保持所需的代码样式。

IDE 包含两个预定义方案： 项目 方案和 默认 方案。

  • 对于 项目 方案，所配置的设置仅适用于当前项目。

    这些设置存储在 codeStyles 文件夹的 .idea 下，并通过 VCS 与项目一起共享。

    在修改项目的代码样式设置后，IDE 将创建该文件夹。

  • 在 默认 方案（IDE 级别方案）中，所配置的设置将应用于所有选用了 默认 代码样式方案的现有项目。

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

如果希望将项目代码样式方案用作默认方案，您可以将其复制到 IDE 级别。 反之也可以：您可以用 IDE 级别方案中的设置覆盖当前项目设置，并与团队其他成员共享。

配置方案

在 GoLand 中，代码样式设置是基于语言的，因此需要为项目中使用的每种语言分别配置。 您还可以将某种语言的设置复制并应用到其他语言。

为某种语言配置代码样式

  1. 按下 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 代码样式。

    要配置 新项目的方案，请转到 文件 | 新建项目设置 | 新建项目的 设置 | 编辑器 | 代码样式。

  2. 选择要配置代码样式的语言。

  3. 选择要配置的代码样式 方案： 项目 方案或某个 IDE 级别方案。

  4. 浏览各个选项卡并配置代码样式偏好设置。

    使用对话框右侧部分预览更改内容。 更改某个设置后，预览区域会出现一个或多个闪烁区域以突出显示所做更改。

在特定作用域中禁用代码格式化

  1. 在 设置 Ctrl+Alt+S 中，选择 编辑器 | 代码样式。

  2. 点击 格式化器 选项卡。

  3. 在 不设置格式 字段中，指定包含要从 重排、 代码整理和 导入优化中排除的文件和目录名称的 glob 模式 ，例如： *.{html,htm}。

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

    使用星号 * 通配符可完全禁用重排操作。

应用其他语言的代码样式

对于大多数受支持语言，可从其他语言或框架中复制代码样式设置。

  1. 按下 Ctrl+Alt+S 打开设置，然后选择 编辑器 | 代码样式。

    要配置 新项目的方案，请在主菜单中转到 文件 | 新建项目设置 | 新建项目的 设置 | 编辑器 | 代码样式。

  2. 选择要配置代码样式的语言。

  3. 选择要修改的代码样式 方案： 项目 方案或某个 IDE 级别方案。

  4. 点击右上角的 设置来源。

    仅当可以应用其他语言的代码样式设置时，才会显示此链接。

  5. 在出现的列表中，选择要从中复制代码样式的语言。

使用 EditorConfig 按目录级别管理代码样式

GoLand 允许您使用 EditorConfig 支持为每组文件分别管理所有代码样式设置（默认情况下在 设置 对话框中启用（Ctrl+Alt+S））。 您只需在包含要定义代码样式的文件的根目录中放置 .editorconfig 文件。 您可以在项目中根据需要创建任意数量的 .editorconfig 文件，从而为不同模块指定不同的样式。

.editorconfig 文件中的所有选项将在其所在目录及其所有子目录中应用，并覆盖当前项目的代码样式。 如果 .editorconfig 中未定义某项，则将使用项目设置中的相应配置。

.editorconfig 文件中的所有选项分为以下几类：

  • 标准选项，如 indent_size、 indent_style 等。 这些选项没有任何特定领域的前缀。

  • 通用 IntelliJ 选项包含 ij_ 前缀，适用于所有语言：

    • ij_visual_guides

    • ij_formatter_off_tag

    • ij_formatter_on_tag

    • ij_formatter_tags_enabled

    • ij_wrap_on_typing

    • ij_continuation_indent_size

    • ij_smart_tabs

  • 常用 IntelliJ 选项被许多（但不是全部）语言支持。 这些选项以 ij_any 为前缀，例如 ij_any_brace_style。

  • 特定语言的 IntelliJ 选项以 ij_<lang>_ 为前缀，其中 <lang> 是语言域 ID（通常是语言名称的小写），例如 ij_java_blank_lines_after_imports。

添加 .editorconfig 文件

  1. 在 项目 视图中，右键单击包含要定义代码样式的文件的源目录，并从上下文菜单中选择 新建 | EditorConfig。

  2. 选择您希望定义的属性，以便 GoLand 为其创建存根，或者将所有复选框保持为空以手动添加所需属性。

  3. 要预览代码样式设置更改如何影响实际源文件，请在 .editorconfig 文件的边栏中点击 眼睛图标 ，然后选择受其影响的源文件。 预览将在右侧打开。

    editorconfig 预览

    您可以在预览窗格中进行更改，以尝试测试配置更改的效果，而无需担心对源代码造成非预期的更改：关闭 .editorconfig 文件后，所有这些更改将被放弃。

提高效率的技巧

换行调用参数、函数参数以及复合字面量元素

  • 要配置函数调用参数、函数参数以及复合文字元素的换行方式，请按 Ctrl+Alt+S 打开设置，并导航至 编辑器 | 代码样式 | Go | 换行和大括号。 。

    代码格式化：为调用参数、函数参数以及复合字面量元素换行

使用意图操作换行参数

  • 要在函数签名中换行参数，请将光标置于左括号前，按 Alt+Enter 调用意图操作，并选择 将参数置于不同的行上。 要撤销此操作，请按 Alt+Enter 并选择 将参数置于同一行。

    intention_actions_for_wrapping
最后修改日期： 2025年 9月 26日
代码风格与格式设置EditorConfig