Go 1.16起GO111MODULE默认on，但仍需手动设为on以确保行为一致；模块路径须按最终import地址预设（如github.com/yourname/mytool），避免简名或本地路径。
GO111MODULE=on 还需要手动设吗？
Go 1.16 起默认启用 Module 模式，GO111MODULE 环境变量已“过时”，但不等于可以不管——它仍会直接影响行为一致性。尤其当你在 $GOPATH/src 下误建项目、或 CI 使用旧版 Go（如 1.15），GO111MODULE=auto 可能静默退回到 GOPATH 模式，导致依赖找不到、go build 报 no required module provides package。
- 运行
go env GO111MODULE，输出不是on就要干预 - Linux/macOS：执行
go env -w GO111MODULE=on（比export更可靠，永久生效） - Windows PowerShell：用
go env -w GO111MODULE=on，别用$env:GO111MODULE="on"（仅当前会话） - 旧项目迁移时，务必确认当前目录不在
$GOPATH/src内，否则模块模式可能被绕过
go mod init 的模块路径怎么写才不翻车？
模块路径不是项目名，而是未来别人 import 你包时的完整路径，错一次，所有 import 语句、CI 构建、版本发布都要改。
- 正确写法：
go mod init github.com/yourname/mytool（即使代码还没推 GitHub，也按最终公开地址预设） - 绝对避免：
go mod init mytool（无命名空间，易冲突）、go mod init /home/user/mytool（本地路径，go build直接报错） - 大小写和下划线慎用：虽然 Go 工具链支持，但某些私有代理（如 JFrog Artifactory）会强制小写，导致
github.com/YourName/My_Tool→ 404 - 内部工具可模拟域名：
go mod init example.org/internal/cli，比mycli更可持续
依赖下载失败？先看 GOPROXY 和 GOPRIVATE
国内直接连 proxy.golang.org 基本超时，而没配 GOPRIVATE 时，私有仓库（如 git.company.com/foo/bar）会被代理拦截并返回 404，错误常表现为 unknown revision 或 verifying ...: checksum mismatch。
