Go模块路径必须全小写，含大写字母会直接报错；合法字符仅限小写字母、数字、点、下划线和连字符；修改路径需同步更新所有import语句并清理依赖。
Go模块路径里出现大写字母会直接报错
Go 1.11+ 的模块系统（go.mod）要求模块路径（module 指令后的字符串）必须是小写 ASCII 字符，否则 go build、go list 等命令会在解析阶段失败，报类似 invalid module path "github.com/MyOrg/MyRepo": malformed module path "github.com/MyOrg/MyRepo": uppercase letters not allowed 的错误。
这不是警告，是硬性拒绝——Go 工具链在读取 go.mod 时就校验路径格式，根本不会进入编译流程。
- 常见触发场景：从 GitHub 页面复制仓库地址时没注意大小写（比如
https://github.com/AcmeCorp/HTTPClient），直接粘贴进module声明 - 本地初始化时用
go mod init MyProject，但当前目录名含大写，go工具会默认用目录名作模块路径 - 团队协作中有人手动改过
go.mod里的module行，加了驼峰或缩写（如MyAPI）
正确写法只有一条规则：全小写 + 连字符替代驼峰
模块路径本质是导入标识符，不是显示名称。它要能被其他项目稳定引用，所以必须可预测、无歧义。Go 官方明确要求：只允许小写字母、数字、点（.）、下划线（_）和连字符（-）。
例如：github.com/acmecorp/httpclient 是合法的；github.com/acmecorp/HTTPClient 或 github.com/acmecorp/Httpclient 都非法。
立即学习“go语言免费学习笔记（深入）”；
- 不要试图用
go mod edit -module强行覆盖为含大写的路径——改完也跑不起来 - 如果原仓库 URL 含大写（如 GitHub 组织名/仓库名本身是大写），模块路径仍需小写：路径是逻辑命名空间，不是镜像 URL
- 内部私有模块同理，比如
git.internal.company/Platform/ApiGateway必须写成git.internal.company/platform/apigateway
迁移已有含大写路径的模块要重写 import 路径
一旦模块路径改了，所有 import 语句都得同步更新，否则编译失败。这不是简单的文件替换，而是整个模块的“重命名”操作。
典型步骤：
- 先用
go mod edit -module github.com/acmecorp/httpclient更新go.mod中的module行 - 再批量修改所有
import语句，把旧路径（如"github.com/AcmeCorp/HTTPClient"）替换成新路径（"github.com/acmecorp/httpclient"） - 运行
go mod tidy清理旧依赖引用，检查是否还有残留的旧路径出现在go.sum或间接依赖中 - 特别注意：如果该模块被其他项目依赖，下游项目也必须升级 import 路径，否则
go get会拉到旧版或报错
CI/CD 和 GOPROXY 容易忽略大小写一致性
本地改完可能一切正常，但 CI 流水线跑 go test 或发布时突然失败，往往是因为构建环境用了不同版本的 Go（如 1.16+ 对路径校验更严格），或者代理服务（如 Athens、JFrog）缓存了旧的模块元数据，返回的 go.mod 文件仍含大写路径。
- 检查
GO111MODULE=on和GOPROXY设置，确保不绕过校验 - 用
go list -m all在 CI 中打印实际解析出的模块路径，确认没有意外的大写残留 - 私有代理若支持，开启路径规范化（canonicalization）功能；不支持的话，只能人工清理缓存并强制刷新
最麻烦的不是改代码，是让所有上下游对齐这个小写约定——尤其当模块已发布多个版本、被多个团队引用时，路径变更相当于一次破坏性升级。
