Appearance
IDEA 运行 Go Module 测试报错：module ... does not contain package ... 的排查与解决
背景
项目使用 Go Modules，go.mod 声明如下：
go
module github.com/fishfinal/apply/v2
go 1.26.6
require (
github.com/channellabs/capacity v1.2.0
)项目物理路径位于 $GOPATH/src/github.com/fishfinal/apply。
main.go 中的自身包导入路径是正确的，例如：
go
import (
"github.com/fishfinal/apply/v2/cmd/applygenctl/config"
"github.com/fishfinal/apply/v2/cmd/applygenctl/order"
)但在 IDEA 中运行 config_test.go 时，编译失败。
问题现象
IDEA 运行测试报错：
go: finding module for package github.com/fishfinal/apply/cmd/applygenctl/config
go: downloading github.com/fishfinal/apply v1.16.0
go: finding module for package github.com/fishfinal/apply/cmd/applygenctl/config
# github.com/fishfinal/apply/cmd/applygenctl/config
FAIL github.com/fishfinal/apply/cmd/applygenctl/config [setup failed]
module github.com/fishfinal/apply@latest found (v1.16.0), but does not contain package github.com/fishfinal/apply/cmd/applygenctl/config
FAIL
Compilation finished with exit code 1这里有两个关键信息值得注意：
- 请求的模块路径是
github.com/fishfinal/apply，缺少/v2； - 工具链回退去拉取远程的
v1.16.0，而不是使用本地模块。
这说明问题不在代码本身，而在工具链解析路径的方式。
排查过程
1. 检查代码中的导入路径
main.go 中所有自身包的导入都正确带上了 /v2，例如：
go
"github.com/fishfinal/apply/v2/cmd/applygenctl/config"代码层面没有问题。
2. 检查 go.mod
go.mod 中模块声明为 github.com/fishfinal/apply/v2，也没有问题。
3. 定位错误信息中的路径差异
错误信息中请求的是：
github.com/fishfinal/apply/cmd/applygenctl/config而正确的应该是：
github.com/fishfinal/apply/v2/cmd/applygenctl/config说明 Go 工具链在解析这个包时，丢失了 /v2 后缀。
4. 分析原因
项目物理路径是 $GOPATH/src/github.com/fishfinal/apply，而模块路径是 github.com/fishfinal/apply/v2。
在 GOPATH 模式下，Go 工具链基于物理路径推导导入路径，会得到 github.com/fishfinal/apply/cmd/applygenctl/config（没有 /v2），然后去远程仓库找这个包，自然找不到——v2 的新功能并不存在于 v1.16.0 中。
而在 Go Modules 模式下，工具链会基于 go.mod 声明，正确解析为 github.com/fishfinal/apply/v2/...。
因此可以推断：IDEA 在运行测试时，没有启用 Go Modules 集成，回退到了 GOPATH 模式，导致 /v2 丢失。
排查流程图
解决方案
核心操作：启用 IDEA 的 Go Modules 集成
打开：
File → Settings → Go → Go Modules勾选：
- ✅ Enable Go modules integration
- 可选：在 Environment 中加上
GO111MODULE=on
勾选后，IDEA 会完全基于 go.mod 解析包路径，所有导入都会带上 /v2，问题立即解决。
如果仍然报错
依次执行：
bash
go clean -modcache
go mod tidy
go test ./cmd/applygenctl/config/...如果命令行能通过而 IDEA 不能，说明问题仍在 IDEA 配置。此时可尝试：
- File → Invalidate Caches → Invalidate and Restart
- 重启后点击 Reload All Maven Projects（或 Go Modules 刷新按钮）
- 检查 Run → Edit Configurations 中的 Working directory 和 Go tool arguments
原理补充：Go Modules 的 /vN 规则
Go Modules 要求 v2 及以上版本必须在模块路径末尾添加 /vN 后缀：
| 版本 | 模块路径示例 |
|---|---|
| v0 / v1 | github.com/user/repo |
| v2 | github.com/user/repo/v2 |
| v3 | github.com/user/repo/v3 |
因此，模块内所有包的导入路径都必须带上 /v2，例如：
go
import "github.com/fishfinal/apply/v2/cmd/applygenctl/config"如果某个工具（如 IDE、旧版 Go 命令）没有正确识别 go.mod，就可能基于物理路径推导出缺少 /v2 的错误路径，进而去远程仓库拉取不存在的包。
经验总结
| 问题 | 原因 | 解决 |
|---|---|---|
编译报错 does not contain package | 导入路径缺少 /v2 | 确保启用 Go Modules 集成 |
| IDEA 运行测试回退 GOPATH 模式 | 未勾选 Go Modules 集成 | Settings → Go → Go Modules 勾选 |
| 缓存导致索引不一致 | IDEA 缓存过期 | Invalidate Caches 并重启 |
一句话总结：Go Modules 项目在 IDEA 中运行测试前，务必确认 Enable Go modules integration 已勾选，避免工具链回退 GOPATH 模式导致 /vN 路径丢失。
