goland默认启用goimports自动管理import，需正确配置use goimports、有效go.mod及vendor支持，手动触发仅清理不补全，补全需alt+enter，分组逻辑由goimports控制而非ide设置。
GoLand 会自动管理 import，但默认行为常不满足项目规范
GoLand 默认启用 goimports（而非原生 gofmt）处理 import，这点很关键——它能自动增删包、合并标准库与第三方导入、按分组排序。但若没正确配置或项目里存在 go.mod 外的旧路径引用，就会出现“明明有包却标红”“删了又自动加回来”“vendor 下的包被忽略”等问题。
确保以下三点就基本覆盖绝大多数 import 异常：
-
Settings > Go > Imports中勾选Use goimports（不是gofmt） - 确认项目根目录下存在有效的
go.mod，且GO111MODULE=on已生效（终端执行go env GO111MODULE应输出on） - 如果用了
vendor，需在Settings > Go > Vendor中勾选Enable vendoring support，否则 GoLand 会跳过 vendor 目录里的包解析
手动触发 import 优化时，别只用 Ctrl+Alt+O
Ctrl+Alt+O（Windows/Linux）或 Cmd+Alt+O（macOS）是整理 import 的快捷键，但它只做“当前文件”的清理：删除未使用项、排序、合并分组。它不会补全缺失的 import——比如你写了 http.HandleFunc 却没 import "net/http"，这个快捷键不会帮你加。
真正补全 import 的操作是：光标停在未识别标识符上 → 按 Alt+Enter → 选 Import package 'net/http'。这个动作才会写入 import 行，并适配当前模块路径（比如自动转成 example.com/internal/nethttp 这类重命名导入）。
常见误操作：
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
- 写完代码直接按
Ctrl+Alt+O，结果报错“undefined: http”，因为没先补全 import - 多个同名包（如
json和encoding/json）冲突时，Alt+Enter会列出所有可选项，选错会导致运行时 panic - 自定义包路径含
+incompatible后缀（如golang.org/x/net v0.25.0+incompatible），GoLand 可能无法准确定位符号，此时需检查go list -f '{{.Dir}}' golang.org/x/net输出是否可访问
import 分组顺序和空行由 goimports 控制，不是 GoLand 界面设置
很多人在 Settings > Editor > Code Style > Go 里翻找“import 分组规则”，其实这里只有缩进、换行等基础格式，真正的分组逻辑（标准库 / 第三方 / 本地包）和空行策略，完全由 goimports 决定。GoLand 只是调用它。
想调整分组行为？只能改 goimports 配置：
- 在终端运行
go install golang.org/x/tools/cmd/goimports@latest确保版本较新（v0.14+ 支持-local参数） - GoLand 中进入
Settings > Go > Imports > goimports options，填入-local example.com（替换成你模块的根路径），这样所有以example.com开头的包会被归为“本地组”，与第三方包之间插入空行 - 不填
-local时，goimports 默认只把标准库和非标准库分开，本地包和第三方混在一起，容易造成维护混乱
vendor 或 replace 导致 import 标红，但代码能跑？检查 GOPATH 和 module cache
典型现象：函数调用无报错、go run 正常，但 GoLand 里 import 行标黄/标红，提示 “Cannot resolve symbol”。这通常不是语法问题，而是 GoLand 的索引没同步到 vendor 或 replace 后的真实路径。
优先排查顺序：
- 执行
go mod vendor后，右键点击项目根目录 →Reload project（不是重启 IDE），强制刷新 module graph - 若用了
replace（如replace github.com/sirupsen/logrus => ./forks/logrus），确认./forks/logrus是完整 Git 仓库（含go.mod），且 GoLand 没把它当成普通文件夹（右键文件夹 →Mark Directory as > Excluded会导致索引跳过） - 极少数情况是
$GOPATH/pkg/mod/cache损坏，可删掉cache/download子目录后执行go mod download重建
最隐蔽的点：GoLand 的 GOROOT 和 GOBIN 设置可能被手动改过，导致它调用的 goimports 版本与 go 命令不一致——在 Settings > Go > GOROOT 和 Settings > Tools > Terminal 里核对 go version 输出是否一致。
