Go模块从本地引用切换到远程路径的开发疑问

先解决核心问题：模块路径写错了 #

你现在用的gitlab.com/<group>/core.git/validate是错误的模块路径——Go模块的路径不需要带.git后缀，正确写法应该是gitlab.com/<group>/core。

1. 打开core仓库的go.mod，把第一行的module声明改成：

   module gitlab.com/<group>/core
   

2. 把core模块内部所有跨包引用（比如config引用validate）的路径改成：

   import "gitlab.com/<group>/core/validate"
   

这个错误是导致IDE找不到本地模块的关键——带.git的路径会被Go识别成未在本地关联的远程模块，自然会去mod缓存或者远程服务器查找。

用go.work实现本地开发免推送 #

要让本地修改无需推送就能生效，必须用Go工作区（go.work）把所有本地模块关联起来：

• 找一个统一的工作区目录（比如把所有拆分后的仓库都放在~/my-projects/下），在这个目录下执行：

  go work init
  

• 然后把每个本地模块添加到工作区：

  go work use ./core  # 假设core仓库在当前目录的core子文件夹下
  go work use ./api   # 其他拆分后的模块同理
  

• 这个go.work文件是本地开发专用的，不需要提交到Git仓库。

修复GoLand的引用提示问题 #

1. 打开GoLand的设置（Settings），找到Go -> Go Modules，勾选Enable Go workspace；
2. 执行go clean -modcache清除模块缓存；
3. 重启GoLand，等待项目重新索引完成。

本地开发的正确流程 #

• 直接修改本地模块代码，不用推送到远程；
• 依赖该模块的其他本地项目（比如api）会通过go.work直接读取本地core的最新代码，不需要go get；
• 只有当你需要把修改同步给其他开发者时，才给core模块打版本tag（比如git tag v1.2.3）并推送到远程，然后在依赖模块里执行go get gitlab.com/<group>/core@v1.2.3拉取正式版本。

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