在 go 项目中导入本地包需先用 go mod init 初始化模块并声明 module 路径，再按“module路径+子目录”格式绝对导入，如 import "example.com/myapp/internal/utils"，禁止使用相对路径或无前缀导入。
在 Go 项目中导入本地包（即项目内部自定义模块），关键在于正确设置模块路径和目录结构，并使用相对或绝对的导入路径。Go 不支持像 Python 那样的“当前目录导入”，而是依赖 go.mod 定义的模块根路径 + 包所在子目录路径来定位。
确保项目已初始化为 Go 模块
Go 1.11+ 推荐使用模块（module）管理依赖和本地包。若尚未初始化，先在项目根目录运行：
-
go mod init your-module-name（如go mod init example.com/myapp） - 这会生成
go.mod文件，其中module行声明了整个项目的模块路径 - 该路径将成为所有本地包导入的“基准前缀”
按目录结构组织代码并使用模块路径导入
假设你的项目结构如下：
myapp/
├── go.mod # module example.com/myapp
├── main.go
└── internal/
└── utils/
└── string.go
在 string.go 中定义一个包：
立即学习“go语言免费学习笔记（深入）”；
// internal/utils/string.go
package utils
<p>func Reverse(s string) string {
// ...
}
那么在 main.go 中应这样导入：
-
import "example.com/myapp/internal/utils"（推荐：基于模块路径的绝对导入） - 不是
import "./internal/utils"或import "utils"—— Go 不支持这两种写法 - 导入路径 =
go.mod中的module名 + 子目录路径
避免常见错误
以下做法会导致编译失败或行为异常：
- 未运行
go mod init就尝试导入子目录 —— Go 无法解析路径，报cannot find package - 包名（
package xxx）与目录名不一致 —— 虽然语法允许，但易引发混淆，建议保持一致 - 把本地包放在
$GOPATH/src下并用旧式 GOPATH 模式开发 —— 已不推荐，容易与模块模式冲突 - 在
go.mod中误删或修改module行，导致导入路径失效
验证与调试技巧
遇到导入问题时可快速检查：
- 运行
go list -f '{{.Dir}}' example.com/myapp/internal/utils确认 Go 是否能定位到该包目录 - 执行
go build或go run main.go，观察是否提示no required module provides package—— 多为模块路径或目录路径不匹配 - 用
go mod graph | grep utils查看模块依赖关系（需已成功构建过）
