Go中本地包导入需通过模块路径而非相对路径，先执行go mod init初始化模块并设置唯一模块名，再按“模块名/子目录”格式导入，如import "example.com/myproject/utils"，且子包目录下须声明对应package名。
在 Go 中实现本地包导入，核心在于理解 模块（module） 与 包路径（import path） 的关系。Go 不支持传统意义上的“相对路径导入”（如 import "./utils"），而是通过模块根目录下的包路径来定位。正确配置 go.mod 和组织目录结构，才能让本地包被正常识别和导入。
确保项目已初始化为 Go 模块
Go 1.11+ 推荐使用模块管理依赖。若尚未初始化，请在项目根目录执行：
-
go mod init example.com/myproject（模块名可自定义，建议用有意义的域名/路径） - 执行后会生成
go.mod文件，其中包含模块名和 Go 版本声明 - 模块名决定了你导入本地子包时的前缀，例如
example.com/myproject/utils
按模块路径组织目录并导入本地包
假设项目结构如下：
myproject/
├── go.mod
├── main.go
└── utils/
└── helper.go
那么在 main.go 中应这样导入：
立即学习“go语言免费学习笔记（深入）”；
-
import "example.com/myproject/utils"（不是"./utils"或"utils"） -
utils目录下需有package utils声明（helper.go开头需写package utils） - 导入后即可调用
utils.SomeFunc()
避免常见错误
以下做法会导致编译失败或行为异常：
- 在未运行
go mod init的目录中直接 import 模块路径 —— Go 无法解析路径 - 包名（
package xxx）与目录名不一致 —— 可能导致符号不可见或 lint 报错 - 在
main.go同级新建lib/并尝试import "lib"—— 缺少模块前缀，Go 认为是标准库或远程包 - 跨模块引用未发布本地包（如两个独立
go.mod）—— 需用replace指令或统一为单模块
多模块协作时使用 replace（进阶）
当本地有多个模块、且希望主模块引用未发布的另一个本地模块时，可在主模块的 go.mod 中添加：
replace github.com/user/othermodule => ../othermodule
然后在代码中照常 import "github.com/user/othermodule"。注意：replace 仅影响当前模块构建，不改变包的真实导入路径。
