“import path mismatch”错误源于import路径、go.mod中module声明与实际目录名大小写不一致。需统一三者大小写，用git mv重命名并清理git大小写缓存，在CI中校验目录名全小写。
go mod tidy 报错 “import path mismatch” 是文件名大小写问题
Go 模块系统对 import path 的大小写极其敏感，而操作系统（如 macOS、Windows）的文件系统默认不区分大小写，但 Linux 区分。当你在 macOS 上把 github.com/owner/repo 克隆成 github.com/owner/Repo（首字母大写），或本地路径中混用 utils 和 Utils，go mod tidy 就会在 CI（Linux 环境）或严格模式下报类似错误：
import path mismatch: import "github.com/owner/Repo" but the code in /path/to/Repo expects "github.com/owner/repo"
这不是版本冲突，而是模块路径声明与实际文件系统路径不一致。根本原因是：go.mod 里写的 module 名、import 语句里的路径、磁盘上真实目录名三者必须完全一致（包括大小写）。
检查并统一 import path 与本地目录名
先确认问题是否由大小写引起：
立即学习“go语言免费学习笔记（深入）”；
- 运行
go list -m -f '{{.Path}} {{.Dir}}' all | grep your-module，看输出的.Dir路径是否和.Path中的域名/路径大小写完全匹配 - 用
ls -F或find . -maxdepth 2 -type d -name "*[A-Z]*"扫描项目内含大写字母的目录名，尤其关注 vendor 下或子模块目录 - 打开所有
go.mod文件，检查module行——比如写成了module github.com/MyOrg/MyLib，但远程仓库真实 URL 是github.com/myorg/mylib
修复方式只有两个字：**重命名**。不能靠 replace 或 exclude 绕过，因为 Go 在解析 import 时就失败了，根本走不到依赖版本选择阶段。
git 仓库历史中的大小写残留要清理
即使你本地已重命名，git 可能仍记录着旧大小写路径（尤其在 macOS 上），导致 git status 不显示变更，但 go build 仍失败。执行以下操作清空缓存并强制同步：
- 运行
git config core.ignorecase false（临时关闭忽略大小写） - 用
git mv -f oldname newname重命名（不是 shellmv） - 如果旧名已被删、新名已建，先
git rm -r oldname，再git add newname - 提交后，在 CI 或 Linux 环境验证
go mod download是否成功
注意：git mv 是唯一安全的方式；直接 rm + add 会丢失历史，且可能让其他协作者拉取时遇到路径冲突。
避免下次踩坑：CI 和本地开发环境一致性
大小写问题往往只在 CI（Linux）暴露，本地（macOS）却正常，这是最危险的情况。建议：
- 在
.gitattributes中加一行：* export-ignore（防止大小写敏感文件被忽略） - CI 脚本开头加检查：
find . -path './vendor/*' -o -path './.git/*' -prune -o -type d -exec basename {} \; | grep '[A-Z]' || true，发现大写目录就 fail - 团队约定：所有模块路径、目录名、import 字符串全部小写，除非上游强制要求（如某些 SDK 的官方命名）
真正麻烦的不是改一次，而是改完之后有人又从 GitHub 直接 clone 一个大小写不一致的 fork 进来——这种问题不会报版本冲突，也不会进 go.sum，它卡在 import 解析第一关，而且错误信息里藏得深。
