在项目根目录执行go mod init 模块名初始化模块；2. 创建包并确保导入路径为模块名加子目录；3. 使用replace指令处理多模块本地依赖。

在golang中导入本地模块，关键是正确配置模块名和路径。从Go 1.11开始引入了Go Modules，使得管理依赖和本地包更加清晰。下面是如何操作的具体方法。

初始化本地模块

在你的项目根目录下运行命令：

go mod init 模块名

例如：

go mod init myproject

这会生成一个go.mod文件，用来记录模块名和依赖信息。

立即学习“go语言免费学习笔记（深入）”；

创建本地包并导入

假设你的项目结构如下：

myproject/
├── go.mod
├── main.go
└── utils/
└── helper.go

在helper.go中定义一个包：

package utils

func SayHello() {
println(“Hello from utils”)
}

在main.go中导入这个本地包：

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

27

查看详情

package main

func main() {
utils.SayHello()
}

注意导入路径使用的是你在go.mod中定义的模块名加上相对路径。

确保路径一致性

Go通过模块名+子目录路径来定位包。如果模块名是myproject，那么utils包的完整导入路径就是myproject/utils。不能写成相对路径如./utils。

常见问题包括：

• 模块名拼写错误
• 目录结构与导入路径不匹配
• 未在go.mod所在目录运行go run或go build

跨目录或多模块处理

如果你有多个本地模块需要相互引用，推荐将它们放在同一个模块下，通过子目录组织。若必须拆分为独立模块，可以使用replace指令在开发阶段指向本地路径：

// 在 go.mod 中添加
replace othermodule => ../othermodule

这样可以在不发布到远程仓库的情况下测试本地依赖。

基本上就这些。只要模块名正确、路径一致、导入语句匹配，本地模块导入就能顺利工作。