go框架项目必须用go mod，模块路径应为未来import的完整url（如github.com/yourorg/myapi），不可用本地名；依赖需指定语义化版本，go.sum必须提交且不可删，多模块须避免循环依赖，go111module=on须显式设置。
Go 框架项目必须用 go mod，且初始化时模块路径不能写本地名（如 myapp），否则后续引用、发布、CI 构建全会出问题。
go mod init 时模块路径怎么写才对
模块路径不是项目文件夹名，而是未来别人 import 你代码时的完整导入路径。它应指向真实可访问的代码托管地址，比如：github.com/yourorg/myapi 或 git.company.com/internal/auth。
- 错误写法：
go mod init myapp—— 这会导致go.sum校验失败、他人无法go get、私有模块代理失效 - 正确写法：
go mod init github.com/yourorg/myapi—— 即使代码还没 push，只要路径逻辑一致即可 - 如果项目是内部系统且不对外公开，仍需用组织内统一域名前缀，例如
internal.mycompany.com/backend，并配合GOPRIVATE设置
添加框架依赖（如 Gin/Echo）该用什么命令
不要直接 go get github.com/gin-gonic/gin，默认拉的是 @latest，可能引入不兼容变更或预发布版。应显式指定语义化版本。
- 推荐方式：
go get github.com/gin-gonic/gin@v1.9.1—— 精确控制主版本和补丁号 - 若需调试某次提交：
go get github.com/gin-gonic/gin@3a7b2f1，但上线前必须换回稳定 tag - 避免
go get -u全局升级：它会递归更新所有间接依赖，极易触发 MVS（最小版本选择）意外降级 - 添加后立刻运行
go mod tidy，它会补全go.sum、清理未引用项，并标记// indirect的传递依赖
go.sum 文件能不能删？要不要提交到 Git？
go.sum 不是缓存，是校验锁。删了会导致构建不可重现，不提交等于放弃供应链安全。
- 必须提交到版本库 —— 它保障所有人下载的每个依赖包哈希值完全一致
- 禁止手动编辑
go.sum—— 若出现校验失败，先检查是否被代理污染（如 GOPROXY 配置了不可信镜像），再运行go mod download或go mod verify - CI 流水线建议加一步
go mod verify，失败即中断构建，防患于未然 - 若团队使用私有仓库，需同步配置
GOSUMDB=off或自建 sumdb，否则go.sum校验会因无法连接官方数据库而报错
多模块项目（如 api + pkg + cli）怎么避免循环依赖
子模块不是“文件夹”，而是独立可复用单元。循环依赖在 Go 编译期直接报错，且无法绕过。
- 每个子目录若需独立构建或被外部引用，就该有自己
go.mod，module 名为完整路径，如github.com/yourorg/myapp/pkg - 主模块通过 import 路径引用，如
import "github.com/yourorg/myapp/pkg"，而非import "./pkg" - 禁止 A 模块 import B，B 又 import A —— 这不是风格问题，是编译器硬性拒绝
- 真正共享的逻辑应拆成第三模块（如
github.com/yourorg/myapp/core），由 A/B 分别依赖，而不是用replace或 symlink 做临时缝合
最常被忽略的一点：GO111MODULE=on 在旧脚本或 Dockerfile 中没显式设置，会导致某些环境下 fallback 到 GOPATH 模式，go.mod 被无视——务必在 CI 和容器启动命令中明确声明。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
