Go模块路径含大写字母会直接报错，因Go 1.13+强制要求module声明必须全小写ASCII字符，否则go build等命令拒绝执行；修复需同步更新go.mod中的module行、所有import语句，并运行go mod tidy。
Go模块路径中出现大写字母会直接导致构建失败
Go 1.13+ 强制要求模块路径（module 声明）必须是小写 ASCII 字符，且不能包含大写字母。一旦 go.mod 文件里写了类似 module github.com/MyOrg/MyRepo，go build 或 go mod tidy 就会报错：invalid module path "github.com/MyOrg/MyRepo": leading capital letter。这不是警告，是硬性拒绝——Go 工具链直接退出。
修复方法：重命名模块路径并同步更新所有引用
不能只改 go.mod 里的 module 行，否则导入路径不一致会导致编译失败。必须三步同步操作：
- 用小写形式重写
go.mod中的module行，例如改为module github.com/myorg/myrepo - 检查所有
.go文件顶部的import语句，把旧路径（含大写）全部替换成新路径 - 运行
go mod tidy清理旧依赖、补全新路径的依赖项；再跑go build确认无 import 错误
注意：如果项目已被他人 go get 过，旧路径已发布到公共 registry，改名后需考虑兼容性。此时应发布新版本（如 v2），并在新路径末尾加 /v2，而非强行覆盖旧路径。
为什么 Go 要强制小写？不是风格问题，是设计约束
Go 的模块路径本质是 URL 片段，用于解析和校验。大小写敏感在不同文件系统（如 Windows/macOS 默认不区分大小写）下会导致路径歧义，破坏模块不可变性和可重现性。所以 Go 工具链在解析阶段就做归一化处理——只接受小写，其他一律拒绝。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
常见误操作包括：
- 从 GitHub 页面复制仓库名时没手动转小写（
MyProject→myproject） - 用
go mod init自动推导路径时，当前目录名含大写（mkdir MyProj && cd MyProj && go mod init→ 推出MyProj） - IDE 自动生成
go.mod时保留了原始目录名大小写
CI/CD 和团队协作中容易被忽略的细节
本地改完能跑通，不代表上线就安全。以下两点常被跳过：
- Git 提交前确认
go.mod和所有import行已统一为小写路径；git grep -n "[A-Z]"可快速扫描残留大写字母 - CI 脚本中若显式调用了
go get ./...或go list -m all，要确保这些命令执行环境里的 GOPATH/GOPROXY 不缓存旧路径的 checksum，必要时加go clean -modcache
最麻烦的情况是：模块已被打 tag 发布，而下游项目直接 require 了带大写的旧路径。这时无法靠本地修改解决，只能联系依赖方升级——所以一开始就把路径定死为小写，比事后救火成本低得多。
