这是go模块路径不一致导致的构建错误，需统一go.mod声明路径与所有import路径（含大小写、符号），并执行go mod tidy清理缓存、修正依赖。
go build 报错 “module declares its path as … but was required as …” 怎么办
这是模块路径拼写不一致的典型表现：本地 go.mod 里写的模块路径（比如 github.com/yourname/project）和别人 import 时用的路径（比如 github.com/YourName/project）大小写或拼写不一致。Go 在 1.16+ 默认启用严格路径校验，直接拒绝构建。
解决的关键不是“绕过校验”，而是让所有地方统一。常见诱因有：
- GitHub 用户名大小写变更后没同步更新
go.mod - 复制粘贴 import 路径时多空格、下划线误写成短横线（
my-projvsmy_proj） - 本地开发用相对路径或自定义域名（如
gitlab.internal/myapp），但 CI 中 GOPROXY 或 GOPRIVATE 配置未覆盖该域
先运行 go list -m 看当前解析出的模块路径，再对比 go.mod 第一行 module 声明——二者必须完全一致（包括大小写、符号、协议前缀）。
修改 go.mod 后为什么 go build 还报旧路径错误
因为 Go 缓存了依赖图谱，不会自动重读 go.mod 并刷新所有引用。尤其当项目被其他模块 require 时，错误路径可能藏在 go.sum 或 vendor 目录里。
必须执行三步清理：
- 删掉
go.sum文件（go build会自动生成新版） - 运行
go mod tidy—— 它会重新解析所有import，修正go.mod中的require行，并校验模块路径一致性 - 如果用了
vendor，再跑一次go mod vendor；否则旧 vendor 下的包仍可能含错误 import
注意：go mod edit -module 只改声明，不修复已存在的 require 行或 import 语句，不能替代 tidy。
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
CI 构建失败但本地正常？检查 GOPROXY 和 GOPRIVATE
本地能过，往往是因为你 clone 的是正确路径的仓库，而 CI 从 proxy 拉取的是别人发布过的旧版本（模块路径写错了），或者 proxy 没命中你的私有域名。
关键配置项：
-
GOPROXY设为https://proxy.golang.org,direct是默认值，但如果你用私有 registry（如 JFrog、Nexus），必须显式设置，且确保其返回的模块元数据中module字段与你本地一致 -
GOPRIVATE必须包含你私有模块的完整域名前缀（如GOPRIVATE=gitlab.internal,github.com/your-org），否则 Go 会强行走 public proxy，导致路径校验失败 - CI 环境里
go env -w设置的变量可能被缓存，建议在构建脚本开头显式 export
验证方式：在 CI 中加一行 go env | grep -E "(GOPROXY|GOPRIVATE)"，确认输出符合预期。
如何预防这类问题反复发生
靠人肉检查不可靠，得靠机制卡点：
- 在
.git/hooks/pre-commit加一行go list -m 2>/dev/null || exit 1—— 提交前强制校验模块路径可解析 - CI 中增加
go list -m all | grep -v "main$" | sort -u | wc -l，比对实际引入的模块数是否异常（多出一个大小写变体就说明有问题） - 团队内约定模块路径全部小写 + 连字符（避免下划线），并在 README 顶部明确写出标准 import 路径，比如：
import "github.com/yourorg/app-core"
最隐蔽的坑是：某些 IDE（如 Goland）在 refactor rename 时会自动改 import，但不改 go.mod 的 module 行——这种半途而废的修改，只会在跨机器构建时突然爆发。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
