Go语言模块管理：从零开始搞懂项目依赖

刚开始写Go程序的时候，很多人都是把所有代码扔在一个文件夹里，跑个hello world挺顺溜。可一旦项目变大，要用别人写好的功能，比如处理JSON、连数据库，这时候就绕不开模块管理了。

什么是Go模块？

简单说，Go模块就是一组相关的包，它们共享同一个版本号，能被别的项目引用。就像你出门旅游要打包行李，模块就是帮你把要用的“工具”整整齐齐装好，带到另一个项目里直接用。

在以前，Go依赖的是GOPATH来管理代码路径，现在早就不用那么麻烦了。从Go 1.11开始，模块系统成了标配。只要一个go.mod文件，就能把项目依赖记清楚。

初始化一个模块

打开终端，进到你的项目目录，运行这条命令：

go mod init example/hello

这就会生成一个go.mod文件，内容类似这样：

module example/hello

go 1.20

module后面是你模块的名字，一般用项目地址，比如github.com/yourname/project。

添加依赖就像加好友

你写代码时import了一个外部包，比如用了gorilla/mux做路由，Go会自动识别并加到依赖里。

写完import语句后，运行：

go mod tidy

它会自动下载缺失的包，并更新go.mod和go.sum文件。go.sum记录的是每个依赖的具体版本和校验值，保证下次拉代码时一模一样，不会因为版本不同出问题。

升级或降级依赖

某个库出新版本了，想试试？可以用：

go get github.com/gorilla/mux@v1.8.0

想回退到旧版本也是一样操作，改个版本号就行。如果想全部升级到最新兼容版本，直接：

go get -u

但别太频繁折腾版本，就像旅行途中突然换路线，可能会遇到没预料的坑。

本地模块调试也很常见

你在公司有多个内部项目，A项目正在开发，B项目要试用A的功能。总不能发版再引用吧？这时候可以用replace指令。

在go.mod里加上：

replace example.com/myproject/moduleA => ../moduleA

这样就把远程依赖替换成本地路径了，改代码立马见效，适合开发调试。

等稳定后再删掉replace，让它正常走发布版本。

模块代理加速下载

国内拉GitHub的代码有时慢得像蜗牛。可以设置代理，让下载快起来。

执行这两条命令：

go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=gosum.io+default

goproxy.cn是国内常用的镜像，能把大部分依赖快速拉下来，就像坐高铁而不是挤公交。

模块管理看起来有点抽象，其实就跟整理出行清单一样：什么东西要带、带哪个版本、从哪儿拿、出了问题怎么换，理清楚了，路就顺了。