golangci-lint 默认不检查 import 排序，必须显式启用 goimports 或 gofmt；二者需在 .golangci.yml 的 linters.enable 中配置，且 goimports 推荐配合 local-prefixes 使用以正确分组。
golangci-lint 默认不检查 import 排序，必须显式启用 goimports 或 gofmt
golangci-lint 本身不内置 import 排序逻辑，它依赖外部 linter 实现。默认配置下，govet、errcheck 等都不碰 import 顺序——所以你运行 golangci-lint run 却没报排序问题，不是规则漏了，是根本没开对应检查器。
真正能强制校验并自动修复 import 排序的，只有两个： goimports（推荐）和 gofmt（基础，不处理空白行与分组）。二者都属于 “formatting linter”，需手动加入 linters.enable 列表，且要确认二进制已安装（go install golang.org/x/tools/cmd/goimports@latest）。
如何在 .golangci.yml 中启用 import 排序检查
确保 .golangci.yml 和 go.mod 在同一目录；否则配置完全不生效。关键配置项如下：
-
linters.enable必须包含goimports（或gofmt），不能只靠默认列表 - 若希望保存时自动修复（VS Code），需额外开启
fix: true，但 CI 中慎用--fix -
goimports默认行为已符合 Go 官方 import 分组规范（标准库 / 第三方 / 本地包），无需额外参数 - 避免同时启用
gofmt和goimports，二者冲突，goimports是超集
示例片段：
linters-settings:
goimports:
local-prefixes: "github.com/yourorg/yourproject" # 告诉它哪些是本地包，用于正确分组
linters:
enable:
- goimports
issues:
exclude-rules:
- path: "_test.go"
linters:
- goimports # 测试文件常含 mock 导入，可选择跳过
为什么 goimports --fix 有时不生效或报错
常见失败原因不是配置写错，而是环境或路径问题：
-
goimports找不到go.mod→ 报no Go files in directory：说明当前工作目录不对，或goimports没读到 module 根 - 本地包前缀没配对 → import 被错误归类为第三方，导致排序乱：必须设置
local-prefixes，且值要和go list -m输出一致 - CI 中未预装
goimports→golangci-lint启动时静默跳过该 linter，也不报错：务必在 CI 脚本里显式安装 - VS Code 中没重启 Go 扩展 → 缓存旧配置，仍走默认规则：改完
.golangci.yml后必须重载窗口
import 排序检查的边界和易忽略点
这项检查看似简单，但实际落地时有三个硬约束容易被绕过：
- 多 module 项目中，每个 module 的
go.mod目录下都得有独立的.golangci.yml，根目录的配置不会向下继承 -
goimports不检查_导入的顺序（比如_ "net/http/pprof"），这类导入需靠revive的blank-imports规则单独管 - 生成代码（如 protobuf、mockgen 输出）必须用
skip-dirs或exclude-rules显式排除，否则goimports可能破坏其结构
最常被忽略的是：即使配置全对，golangci-lint run 也默认只检查当前目录下文件；想扫全项目，得加 . 或 ./...，否则子目录 import 乱序根本不会报。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
