个人项目中的Golang模块依赖管理-Golang-PHP中文网

根本原因是未启用module模式或import路径与go.mod声明的模块路径不匹配；go111module必须为on，且import必须严格使用模块路径而非文件路径。

个人项目中的golang模块依赖管理

go mod init 后为什么 import 还报错

根本原因是没在 module 模式下工作，或者模块路径和 import 路径不匹配。Go 不会自动把包“装进项目”，它只认 go.mod 里声明的模块路径 + 本地文件结构。

常见现象：import "github.com/some/lib" 编译失败，提示 no required module provides package，但 go get github.com/some/lib 看似执行成功。

先运行 go env GO111MODULE，必须是 on；若为 auto 且当前目录无 go.mod，Go 会退回到 GOPATH 模式，把包下到 $GOPATH/src/，但不会写入你项目的 go.mod
go mod init 的参数不是随便起的，比如 go mod init myapp 是错的——模块路径应是未来别人 go get 时用的导入路径，推荐用 go mod init github.com/yourname/myapp
初始化后，别急着 go get；直接写 import、然后 go run main.go，Go 会自动拉取并写入 go.mod（前提是 GO111MODULE=on）

go get -u 为什么总让项目挂掉

因为 go get -u 不管兼容性，只管“最新”。它会递归升级所有依赖到最新 minor/patch 版本，而很多框架（比如 Gin、Echo、Zap）的 minor 升级可能改函数签名、删方法、换日志字段——你的代码还没改，编译或运行时就崩了。

真正安全的做法是：明确指定版本，而不是靠 -u 猜。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

升级某个包到特定版：go get github.com/gin-gonic/gin@v1.9.1（注意带 v 前缀）
想升到最新 tagged 版（跳过未打 tag 的 commit）：go get github.com/gin-gonic/gin@latest
降级或切到 main 分支调试：go get github.com/gin-gonic/gin@main
执行完 go get 后，务必跟一句 go mod tidy —— 它会删掉未引用的依赖，补全间接依赖，并更新 go.sum

私有库或 fork 怎么拉得下来

默认情况下，go get 会走 GOPROXY（如 https://proxy.golang.org），而私有 Git 地址（比如 git.example.com/internal/pkg）无法被公开代理解析，就会报 not found 或 403。

解决的关键是告诉 Go：“这个域名下的模块，别走 proxy，直接 git clone。”

设置 GOPRIVATE=git.example.com/*（支持通配符，多个用逗号分隔）
确保 Git 凭据可用：SSH key 已配置，或 HTTPS 方式已设好 git config --global credential.helper store
如果用 replace 指向本地路径（如 replace git.example.com/internal/pkg => ../pkg），仅限开发阶段；CI 中必须删掉，否则构建失败
验证是否生效：运行 go env GOPRIVATE，确认输出包含你的域名

go.sum 文件能不能删或忽略

不能删，也不能 .gitignore。它是依赖完整性的“指纹锁”，不是可选配置。

常见错误操作包括：CI 中 go mod download 后重新生成 go.sum 并提交、本地开发时手动编辑 go.sum、或干脆不提交它——这些都会导致不同机器上拉代码后依赖内容不一致，甚至被中间人篡改也发现不了。

go.sum 必须和 go.mod 一起提交到 Git
CI 流程中，应在 go build 或 go test 前加一步 go mod verify，提前暴露校验失败
如果本地 go.sum 校验失败，优先清缓存：go clean -modcache，而不是删 go.sum 再 go mod tidy
多人协作时，只要有人改了 go.mod（比如加依赖、改版本），就必须 go mod tidy 并提交新的 go.sum，否则其他人 go build 会直接失败

实际项目里最常被忽略的，是 go.mod 中模块路径和仓库 URL 的一致性——发布 v1.x 版本后，如果改了模块路径（比如从 github.com/a/b 改成 github.com/c/b），下游用户 go get @latest 就会 fallback 到伪版本，再也找不到你打的 tag。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！