Go语言主包添加Git子模块遇导入错误求助

问题背景 #

作为Go语言新手，我想通过Git子模块在主包中引入http_fs模块，实现两个包的同步开发与提交。已执行以下命令添加Git子模块：

git submodule add git@github.com:xxx/http_fs.git repo/http_fs

主包初始导入语句：

package main

import "repo/http_fs"

http_fs模块的go.mod：

module github.com/xxx/http_fs

go 1.19

运行go run main.go时出现错误：

package repo/http_fs is not in GOROOT (/usr/local/go/src/repo/http_fs)

文件结构：

./main.go // main package
./repo/http_fs/http_fs.go

已为主包go.mod添加replace配置：

module main

go 1.19

replace github.com/xxx/http_fs v1 => ./repo/http_fs

错误原因 #

Go模块依赖基于模块路径而非本地文件路径导入。http_fs的模块路径是github.com/xxx/http_fs，但主包却用本地路径repo/http_fs导入，导致Go无法识别该包归属的模块。

解决步骤 #

1. 修正主包导入语句
   将主包中的导入路径改为http_fs的模块路径：

package main

import "github.com/xxx/http_fs"

2. 确保replace配置正确
   主包go.mod中的replace指令已正确将远程模块路径映射到本地子模块目录，若子模块未打版本标签，可省略版本号简化配置：

replace github.com/xxx/http_fs => ./repo/http_fs

3. 同步依赖
   在主包根目录执行命令，让Go解析并同步依赖：

go mod tidy

4. 运行主程序
   再次执行运行命令即可正常启动：

go run main.go

补充说明 #

• Git子模块仅负责版本控制层面的代码关联，Go模块的导入逻辑仍遵循模块路径规则。
• 使用replace指令后，本地修改repo/http_fs中的代码会直接作用于主包，开发完成后可分别进入主包和子模块目录提交Git变更。

内容的提问来源于stack exchange，提问作者clarkk