答案是本地包必须用模块路径而非文件路径导入：go.mod中module声明值为根路径，如module github.com/yourname/myapp，则import需写"github.com/yourname/myapp/internal/utils"，不可用"./internal/utils"。
本地包路径写错导致 go build 报错 “cannot find module”
Go 模块不支持像 Python 那样用相对路径（如 ./utils）直接 import。必须使用模块路径，而这个路径默认是 go.mod 文件里定义的 module 名称开头。
假设你的项目根目录有 go.mod，内容为：
module github.com/yourname/myapp，而你想引入同级目录下的
internal/utils，那 import 必须写成："github.com/yourname/myapp/internal/utils"，不是 "./internal/utils" 或 "myapp/internal/utils"。
- 检查
go.mod第一行的module值，它就是你所有本地包的“根路径” - 本地子目录只要在该模块路径下，就可直接 import —— 不需要额外
replace或require - 如果子目录没有
.go文件或没导出任何符号（比如全小写函数/变量），go build会静默忽略它，但 import 语句仍会报错“imported and not used”
跨模块引用本地代码时必须用 replace
当你想把一个尚未发布、甚至还没放 GitHub 的包当作独立模块复用（比如多个项目共用 shared），又不想推到远程仓库，就得靠 replace 指向本地路径。
例如：主模块是 github.com/yourname/app，想引用本地 ../shared 目录作为 github.com/yourname/shared：
replace github.com/yourname/shared => ../shared
注意：replace 只在当前模块生效，且目标路径必须包含有效的 go.mod（哪怕只是空文件 + module github.com/yourname/shared）。
-
replace后的路径支持绝对路径或相对路径（相对于当前go.mod） - 执行
go mod tidy后，go.sum会记录本地路径的校验和 —— 换机器或 CI 环境时，该路径必须存在且一致，否则构建失败 - 别在
replace中指向未初始化模块的目录，go工具会报 “invalid version: unknown revision”
go mod edit -replace 是临时调试最快的方式
比起手动编辑 go.mod，用命令行加 replace 更适合快速验证、临时切换本地依赖。
比如把 golang.org/x/net 临时换成本地修改版：
go mod edit -replace golang.org/x/net=~/src/net
这条命令会直接写入 go.mod，且不会触发 go mod tidy 自动清理 —— 适合调试阶段反复改。
- 撤销替换：用
go mod edit -dropreplace golang.org/x/net - 路径中含空格或特殊字符？用引号包裹，如
'/Users/name/go projects/mylib' - 该命令不检查目标路径是否真有模块，只做文本替换，出错要靠后续
go build暴露
IDE（如 GoLand）自动导入可能填错路径
按快捷键自动补全 import 时，IDE 有时会基于文件系统路径生成错误的包名（比如把 internal/config 推断成 "config" 或 "myapp/internal/config"），尤其在多模块混用或 GOPATH 模式残留时。
- 始终以
go list -m或go list -f '{{.Module.Path}}' ./path/to/pkg校验目标包的真实模块路径 - 关闭 IDE 的 “auto-import from file system” 类选项，强制用模块路径解析
- 如果
go build成功但 IDE 显示红线，多半是缓存未刷新：执行go mod vendor或点击 IDE 的 “Reload project”
module 声明作用域的理解偏差——特别是当项目结构嵌套、或从 GOPATH 迁移过来时，第一眼看到的目录结构，未必是 import 语句该写的路径。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
