解决:Git 文件名大小写修改在 CI 环境编译失败的坑

2025-09-17后端1 分钟142 次阅读
AI 摘要salmon-ai

本文详细解析了 Git 文件名大小写在 CI 环境中引发编译失败的原因:本地 m

前言

在最近的一个多模块项目中,我遇到了一个奇怪的问题:本地编译一切正常,但推到 Git 后,CI 环境(Linux)构建时出现了编译错误。

问题

本地(macOS)编译 OK,但在 CI(Linux)上构建报错:

bash 复制代码
[ERROR] /home/ci/ms-lemeng-protocol/src/main/java/.../HourlyCategoryVo.java:[9,8] 
class HourlyCategoryVO is public, should be declared in a file named HourlyCategoryVO.java

类似错误还有:

  • HourlyGoodsByCategoryVO
  • HourlyCategoryGoodsVO

经排查,发现我对这三个文件重名了下,从原来的后缀 Vo,改为 VO,然而 Git 文件名大小写不敏感。

  • macOS 默认文件系统(HFS+ 或 APFS)大小写不敏感,所以:
  • 文件名是 HourlyCategoryVo.java
  • 类名改成了 HourlyCategoryVO

本地照样能编译通过。

  • Linux 文件系统是大小写敏感的,所以 CI 编译时认为:
  • 文件叫 HourlyCategoryVo.java
  • 类叫 HourlyCategoryVO

→ 文件名和类名不一致,编译失败。

解决方案

1、使用 git mv 强制重命名

1、先把文件改成临时名字:

bash 复制代码
git mv HourlyCategoryVo.java Temp.java
git commit -m "temp rename to fix case"

2、再改回正确的名字:

bash 复制代码
git mv Temp.java HourlyCategoryVO.java
git commit -m "rename to correct class file name"
git push

2、配置 Git 识别大小写

如果文件比较多,可以让 Git 对大小写敏感:

bash 复制代码
git config core.ignorecase false

然后重新提交文件名:

bash 复制代码
git add -A
git commit -m "fix filename case for VO classes"
git push
觉得有用就点个赞,不用登录也能读

评论

0 条
登录 之后才能评论
—
还没有评论,来说第一句