GoLand 2026.3 Help

使用 go fix 分析代码以进行语法更新

GoLand 会基于 go fix 提供检查。 这些检查可帮助你针对后续 Go 版本新增的语言和标准库变化更新代码。

Go 工具链会分析你的代码。 GoLand 会在编辑器中以 检查 的方式显示结果。 每个检查会识别过时的构造。 支持自动更新的检查会提供快速修复。

在编辑器中应用语法更新

GoLand 使用蓝色下划线和语法更新图标（语法更新图标 ）高亮显示语法更新。

应用语法更新

  1. 将文本光标放在高亮显示的代码元素处。

  2. 点击灯泡图标或按 Alt+Enter。

  3. 选择快速修复后，按 Enter 或点击快速修复。

如果某个发现项没有快速修复，请按 Alt+Enter 并选择 检查 'go fix -<处理项>' 选项 来配置、抑制或禁用该检查。 在此， <pass> 是报告该发现项的 Go 分析器的名称。

有关快速修复的更多信息，请参阅 意图操作。

分析代码以查找其他语法更新

应用语法更新后，GoLand 会在编辑器中显示 分析代码以查找其他语法更新 链接。

分析代码以查找其他语法更新

  1. 点击 分析代码以查找其他语法更新。

  2. 在 指定语法更新范围 对话框中，选择 整个项目 、当前文件或 自定义范围。

  3. 点击 分析。

GoLand 会在 问题 工具窗口的 Go｜Go 修复 下显示结果。

查看并应用语法更新

在 问题 工具窗口中，选择某个检查以查看其描述、受影响的文件及可用的快速修复。

应用语法更新快速修复

  • 要更新一个匹配项，请展开检查和文件节点，选择该匹配项，然后点击 应用修正。

  • 如需更新检查分组内的全部出现位置，选择该分组并点击 应用修正。

在其他作用域中运行检查

  1. 在检查详情中点击 运行检查于

  2. 在检查作用域对话框中，选择整个项目或自定义作用域。

    如需包含注入到字符串中的代码，请选择 检查注入代码。

  3. 点击 确定。

提交时应用语法更新

可以在提交 Go 文件前自动应用 go fix 建议。 此检查默认处于禁用状态。

提交时启用 go fix

  1. 按 Alt+0 打开 提交 工具窗口，然后点击 显示提交选项 设置按钮。

  2. 请选择 运行 go fix。 如果还选中了 Go fmt ，GoLand 会在格式设置前应用语法更新。

该检查会分析当前代码，包括未保存的更改，并且只修改包含在提交中的文件。 如果某项建议还会更改提交以外的文件，GoLand 会跳过整项建议。 将跳过 vendored 软件包以及项目内容之外的软件包。

配置语法更新检查

Go fix 检查默认使用 语法更新 严重级别和 Go 语法更新 高亮显示样式。

配置语法更新检查

  1. 按 Ctrl+Alt+S 打开设置并导航到 编辑器｜检查。

  2. 展开 Go｜Go 修复。

  3. 选择一个检查。 如需一次性配置所有 Go fix 检查，请选择 Go fix 分组。

  4. 从 严重性 列表中选择一个值。

  5. 从 编辑器中高亮显示 列表中选择一个值。

  6. 应用更改并关闭对话框。

2026年 11月 9日
GoLand 中的 VimModern Go Guidelines指南文档平台首页 Go 指南列表目的 Go 版本支持指南查找指南内容安装 Modern Go Guidelines从市场安装从本地仓库安装更新现有 Go 代码 Modern Go Guidelines 是面向 AI 编码代理的开源软件包。它提供与你项目中的 Go 版本兼容的 Go 指导。请参阅 GitHub 上的 Modern Go Guidelines 仓库。AI 编码代理可能会选择过时的 Go 模式。它们的训练数据可能不包含模型知识截止日期之后新增的功能。即使代理知道较新的模式，也可能选择在训练数据中更常出现的较旧模式。Modern Go Guidelines 提供语言功能和标准库 API 的参考。代理会读取项目的 go.mod 文件中声明的 Go 版本。它只会接收该版本中可用功能的指导。例如，在使用 Go 1.25 的项目中工作的代理可以使用 sync.WaitGroup.Go。它不会接收 slices.SortedMap 的指导，因为该功能需要 Go 1.26。Modern Go Guidelines 包含一个命令行工具，提供 guidelines 和 info 子命令。代理通过已安装的技能使用该工具。在编辑 Go 文件之前，代理会为该文件调用 guidelines。该命令返回适用于你项目中 Go 版本的简短指南:guidelines ./handler.go 代理也可以直接指定 Go 版本:guidelines --go 1.25 ./handler.go 输出会从最新的适用指南开始。每条指南都有稳定的 ID:GO125-WAITGROUP-GO use sync.WaitGroup.Go instead of manual Add/Done bookkeeping GO124-OMITZERO use omitzero for Go-zero-value-sensitive JSON fields 当代理需要有关某条指南的更多信息时，会使用指南 ID 调用 info。该命令返回说明以及前后对比示例:info GO125-WAITGROUP-GO 该工作流将指导限制为适用于任务的信息。Modern Go Guidelines 涵盖从 Go 1.0 到 Go 1.27 的实用语言功能和标准库新增内容。它们还包括 Go modernize 分析器涵盖的模式。这些指南可帮助代理使用现代模式，例如:slices.Contains, 而不是手动搜索循环。min 和 max, 而不是手写比较。cmp.Or, 而不是选择第一个非零值的链。sync.WaitGroup.Go, 而不是分别调用 Add、Done 和 go。例如，Go 1.25 或更高版本的指南可以替代手动 sync.WaitGroup 记账:// before var wg sync.WaitGroup for _, item := range items { wg.Add(1) go func() { defer wg.Done() process(item) }() } wg.Wait() // after var wg sync.WaitGroup for _, item := range items { wg.Go(func() { process(item) }) } wg.Wait() sync.WaitGroup.Go 会启动 goroutine，并管理匹配的 Add 和 Done 调用。当 goroutine 的生命周期与 WaitGroup 的生命周期一致时，代理会使用此模式。Modern Go Guidelines 可用于 Junie、Claude Code、Codex、光标以及其他支持技能的编码代理。安装 Go 工具链，并使其可在路径中使用。首次使用时，集成会在本地缓存中安装其命令行工具。它不会修改你的项目。将 Modern Go Guidelines 仓库添加为市场。在 Claude Code 会话中，运行:/plugin marketplace add go-modern-guidelines https://github.com/JetBrains/go-modern-guidelines/blob/main/marketplace.json 在终端中，运行:claude plugin marketplace add go-modern-guidelines https://github.com/JetBrains/go-modern-guidelines/blob/main/marketplace.json 从市场安装插件。启动或重启 Go 项目中的代理。当代理处理 Go 代码时，会使用已安装的技能。获取 Modern Go Guidelines 仓库的本地副本。使用此方法可在发布更改前进行测试。检查仓库是否包含适用于你的代理的市场定义。仓库根目录必须包含 marketplace.json。将本地仓库添加为市场。将示例路径替换为你的仓库的绝对路径。claude plugin marketplace add go-modern-guidelines-local file:///absolute/path/to/go-modern-guidelines/marketplace.json 从本地市场安装插件。对于 Junie、光标、其他代理以及更新说明，请参阅 Modern Go Guidelines 仓库。Modern Go Guidelines 适用于新代码。要查找并更新项目中已有的过时代码，请使用 Go 语法更新检查。