答案：通过go mod使用replace指令可引用本地模块。首先初始化主项目与本地模块，创建utils并编写代码，在主项目go.mod中用require声明依赖，并用replace将模块路径指向本地目录，最后运行go mod tidy和程序即可成功调用本地模块函数。
在Go项目中引用本地模块，是开发过程中常见的需求，尤其是在模块拆分、组件复用或团队协作时。Go语言从1.11版本开始引入了模块（module）机制，使得依赖管理更加清晰和灵活。通过go mod，我们可以方便地引用本地模块，而无需将代码推送到远程仓库。
启用Go Module模式
确保你的项目使用Go Module进行依赖管理。检查项目根目录是否存在go.mod文件。如果没有，运行以下命令初始化：
go mod init 项目名称
例如：
go mod init myproject
该命令会生成一个go.mod文件，用于记录模块依赖关系。
立即学习“go语言免费学习笔记（深入）”；
创建本地模块
假设你有一个本地模块想被主项目引用，比如工具库utils。你可以将其放在项目内部或外部目录中。
例如，在项目根目录下创建一个子目录作为本地模块：
mkdir utils cd utils go mod init github.com/yourname/myproject/utils
然后在utils目录中编写代码，如：
// utils/helper.go
package utils
import "fmt"
func SayHello(name string) {
fmt.Printf("Hello, %s!\n", name)
}
在主项目中引用本地模块
在主项目的main.go中导入该模块：
package main
import "github.com/yourname/myproject/utils"
func main() {
utils.SayHello("Alice")
}
此时直接运行go run main.go会报错，因为Go无法找到远程模块。我们需要在go.mod中使用replace指令指向本地路径。
编辑主项目的go.mod文件：
module myproject
go 1.20
require (
github.com/yourname/myproject/utils v0.0.0
)
replace github.com/yourname/myproject/utils => ./utils
其中：
-
require 声明依赖模块及其版本（本地模块可用伪版本
v0.0.0）。 -
replace 将模块路径重定向到本地相对路径
./utils。
验证并运行项目
保存go.mod后，运行：
go mod tidy
这会自动整理依赖，并应用replace规则。接着运行主程序：
go run main.go
如果输出Hello, Alice!，说明本地模块已成功引用。
基本上就这些。只要配置好go.mod中的require和replace，就能轻松实现本地模块的引用。这种方式特别适合在未发布前调试模块逻辑，也便于多项目共享本地组件。不复杂但容易忽略细节，尤其是模块路径必须与replace一致。
