go 1.16+ 默认启用模块模式，gopath 不再是强制约束，但多模块开发仍需明确工作区结构和 go mod 行为边界——否则会出现依赖冲突、replace 失效、go run 找不到本地包等问题。
Go 1.16+ 默认启用模块模式，GOPATH 不再是强制约束，但多模块开发仍需明确工作区结构和 go mod 行为边界——否则会出现依赖冲突、replace 失效、go run 找不到本地包等问题。
为什么 go mod init 后仍报“cannot find module providing package”
这不是环境没装好，而是当前目录未被 Go 视为模块根，或子模块未正确声明路径。常见于多模块并存时误在父目录外执行 go mod init，导致模块路径与导入路径不匹配。
- 必须在每个独立模块的根目录下运行
go mod init example.com/foo，模块名要和代码中import的路径一致 - 若模块 A 依赖本地模块 B，B 的
go.mod中module行必须是完整路径（如module github.com/user/lib），不能是module lib - 父目录存在
go.work文件时，go命令才自动识别多模块；否则它只认当前目录的go.mod，其他模块会被忽略
如何用 go.work 管理多个本地模块
go.work 是 Go 1.18 引入的多模块工作区机制，替代过去靠 GOPATH 拼凑路径的土办法。它不改变单个模块行为，只让 go 命令知道“这些模块应被一起看待”。
在 Golang 中使用 samber/hot 进行内存缓存，支持 LRU、LFU、TinyLFU、W‑TinyLFU、S3FIFO、ARC、TwoQueue、SIEVE、FIFO 等淘汰算法，提供 TTL、缓存加载器及分片功能。
- 在项目根目录执行
go work init创建空go.work - 逐个添加模块：
go work use ./api ./core ./cli（路径必须是相对于go.work的相对路径） -
go.work文件里会生成类似use ./api ./core的行，不要手动改路径——错一个斜杠就导致go list -m all不显示该模块 - 添加后，在任意子模块目录运行
go run main.go，能直接解析同工作区内的其他模块，无需replace
GOROOT、GOPATH 和 $HOME/go/bin 的实际分工
三者职责清晰，混用就会出问题：GOROOT 是 Go 自身代码和工具链位置；GOPATH 曾是旧式工作区，现仅用于存放 $GOPATH/bin 下的可执行工具（如 dlv、gopls）和 $GOPATH/pkg 缓存；而 go.work 或单个 go.mod 才是源码组织核心。
-
GOROOT必须设为/usr/local/go（或你解压的实际路径），且$GOROOT/bin要在PATH最前面，否则go version可能调到系统旧版 -
GOBIN可显式设置（如export GOBIN=$HOME/go/bin），避免go install把二进制写到$GOPATH/bin以外的位置 - 不要把项目源码放
$GOPATH/src下——Go 1.16+ 不再扫描那里，放了也无效；go mod只认当前目录是否有go.mod
国内环境下 go mod download 卡住或超时
错误信息通常是 dial tcp: i/o timeout 或 Get \"https://proxy.golang.org/...\": context deadline exceeded，本质是没配代理，不是网络不通。
- 立即执行：
go env -w GOPROXY=https://goproxy.cn,direct（direct保留对私有仓库直连，必须带上） - 验证是否生效：
go env GOPROXY应输出该地址；再运行go mod download github.com/sirupsen/logrus，几秒内完成即通 - 如果公司内网有自建代理（如
https://repo.yyrd.com/artifactory/aliyun-golang/），替换上面 URL 即可，,direct仍要保留 - CI/CD 流水线中（如 GitHub Actions），必须在每个 job 步骤里显式设置
go env -w GOPROXY=...，因为 runner 是干净环境
真正容易被忽略的是 go.work 文件的生命周期管理：它不会自动感知新加入的模块目录，每次增删模块都得手动 go work use；另外，go run 在非模块根目录执行时，即使有 go.work 也不会自动加载——必须确保你在 go.work 所在目录或其子目录下操作。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
