go语言禁止import相对路径，必须使用以go.mod中module声明为前缀的绝对模块路径，如import "myapp/utils"，而非"./utils"或"../model"，否则编译器直接报invalid import path错误。
GoLand 项目里用 ./utils 或 ../model 这种相对路径导入，一定会失败——不是 GoLand 的问题，是 Go 工具链本身禁止这么做。
为什么 import "./utils" 会报错：invalid import path
Go 编译器（go build、go test）从不解析文件系统相对路径。它只认两种路径：
- 标准库路径（如
"fmt"、"net/http"） - 模块路径（如
"github.com/yourname/project/utils"），必须匹配go.mod中的module声明
你写的 import "./utils" 在语法上就是非法字符串，go 工具直接拒绝解析，报错 invalid import path: "./utils"。GoLand 只是把底层错误透传出来，不是它配置没调好。
正确做法：用模块路径代替相对路径
假设你的项目结构是：
myapp/
├── go.mod
├── main.go
└── utils/
└── helper.go
那么必须满足三件事：
GoLand 2026.1.1
下载
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
-
go.mod第一行写的是module myapp（或带域名的，如module github.com/you/myapp） -
utils/helper.go文件开头声明package utils -
main.go中写import "myapp/utils"（不是"utils"，也不是"./utils"）
注意：myapp 是模块名，不是目录名。如果 go.mod 里写的是 module github.com/you/myapp，那导入就必须写成 import "github.com/you/myapp/utils"。
GoLand 提示 “unresolved reference” 怎么办
这通常不是导入写错了，而是 GoLand 没识别到模块根目录。检查以下几点：
- 确保
go.mod文件真实存在于项目最外层目录，且被 GoLand 识别为模块根（右键目录 → “Mark Directory as” → “Sources Root” 不要乱点；GoLand 应自动识别go.mod所在目录） - 执行一次
go mod tidy，让 GoLand 重新索引依赖 - 如果用了
replace（比如replace example.com/lib => ../lib），确认../lib路径相对于go.mod是有效的，且那个目录下也有合法的go.mod
别信“配置 GOPATH 就能解决”的老方案——Go Modules 下 $GOPATH 和 src 目录已无关紧要，硬塞进去反而让路径更混乱。
开发阶段想复用隔壁项目的本地包？用 replace，但别提交
比如你正在改 myapp，同时调试隔壁的 common 包，它的模块名是 github.com/you/common：
- 在
myapp/go.mod里加一行：replace github.com/you/common => ../common -
../common必须是相对于myapp/go.mod的有效路径，且该目录下有go.mod - 立刻运行
go mod tidy，否则 GoLand 和go build都可能缓存旧状态 - CI 构建前务必删掉
replace行，或用//go:build !ci注释掉（GoLand 不处理构建约束，但 CI 会）
真正容易被忽略的点是：模块名大小写敏感，replace 左侧必须和 import 语句里写的完全一致，连一个字母都不能错——GoLand 不会帮你校验这个。
