Go import路径必须以go.mod中module声明为前缀，如"github.com/yourname/myapp/utils"；禁用相对路径"./utils"和短路径"utils"，否则编译失败；internal目录受编译器强制校验，仅父级或同级代码可导入。
Go 项目中 import 路径怎么写才对
go 的 import 不是按文件路径导入，而是按模块路径（module path）+ 包名导入。如果你直接写 import "./utils" 或 import "src/utils"，编译会报错：import path must be absolute 或 no required module provides package。
正确做法取决于你的项目是否启用了 Go modules（1.11+ 默认开启）：
- 如果项目根目录有
go.mod文件，import必须以该模块路径为前缀，比如模块声明为module github.com/you/project，那么utils子目录应通过github.com/you/project/utils导入 - 本地包不能用相对路径，也不能省略模块前缀；即便包在当前目录，也要写全模块路径（如
github.com/you/project） - 如果没初始化模块（无
go.mod），go build会退回到 GOPATH 模式，但已不推荐——容易因环境变量或目录结构错乱导致找不到包
如何让 go mod 自动识别并添加本地包
手动写 import 路径容易出错，更可靠的方式是让 go 工具链自动解析和补全：
- 确保项目已初始化：在项目根目录运行
go mod init github.com/you/project（模块名建议用真实仓库地址） - 在代码里先写一个“占位” import，比如
import "github.com/you/project/utils"，哪怕utils目录还不存在 - 运行
go build或go list ./...，它会报错提示 “cannot find module”，但此时go mod tidy就能自动把本地子目录识别为同一模块内的包，并写入go.mod - 注意：子包目录下不需要
go.mod文件，也不允许有——Go modules 是单模块单go.mod的设计
为什么 import "utils" 会失败
这种写法看似简洁，实际违反 Go 的包导入规则：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
-
utils是短路径，Go 会把它当作标准库或第三方包去 $GOROOT 或 $GOPATH/pkg 下查找，不会扫描本地目录 - 即使你把
utils放在$GOPATH/src/utils，也必须用完整路径import "utils"才能命中——但这属于旧 GOPATH 模式，且与模块模式冲突 - VS Code 或 GoLand 的自动补全有时会建议这种短名，但它是基于 GOPATH 索引的遗留行为，启用 modules 后基本不可靠
- 真正安全的标识方式只有两种：标准库（如
fmt）、或带域名的模块路径（如github.com/you/project/utils）
跨模块导入时要注意什么
如果你确实需要从另一个独立模块（比如 github.com/other/lib）导入，流程不同：
立即学习“go语言免费学习笔记（深入）”；
- 不能靠文件系统复制或软链接，必须通过
go get github.com/other/lib@v1.2.0安装 - 安装后，
go.mod会自动添加对应 require 行，import 语句才能解析成功 - 版本不匹配时常见错误是
missing go.sum entry或incompatible version，此时要检查go.sum是否被误删，或用go mod verify校验 - 本地开发调试跨模块包，可用
replace指令临时指向本地路径：replace github.com/other/lib => ../local-lib，但上线前必须删掉
最常被忽略的一点：模块路径不是 URL，而是命名空间——github.com/you/project 只是惯例，你完全可以设成 my.company/internal，只要所有 import 都跟它对得上就行。路径错一个字符，整个构建就断。
