使用Expo&EAS构建Android APK时遇文件名大小写不一致错误求助

这个错误是因为本地文件系统（比如Windows/macOS默认不区分文件名大小写）与Git（严格区分大小写）之间存在文件名大小写不匹配的情况，EAS在构建压缩阶段会校验这一一致性，从而抛出报错。以下是具体解决步骤：

1. 定位大小写不一致的文件 #

执行以下Git命令找出问题文件：

git ls-files --stage | awk '{print $4}' | sort -f | uniq -i -d

或者更直接的命令：

git diff --name-only --diff-filter=I

这两个命令会列出所有Git检测到的、与本地文件系统大小写不一致的文件。

2. 修正文件名大小写 #

• 注意：Windows/macOS系统直接修改文件名大小写可能不会被系统识别，需要先将文件重命名为临时名称，再改回目标大小写。比如要把UserProfile.js改成userprofile.js，先改名为UserProfile_temp.js，再改回userprofile.js。
• 修改完成后，执行git add .将修改同步到Git暂存区，然后提交变更。

3. 配置Git严格区分大小写（可选） #

为了避免后续再出现类似问题，可以让本地Git严格区分文件名大小写：

git config core.ignorecase false

⚠️ 注意：如果团队成员中有使用Windows/macOS的开发者，这个配置可能引发其他协作问题，更推荐统一项目内的文件名大小写规范（比如全部小写或统一驼峰命名）。

4. 重新执行构建 #

确认所有大小写问题修复后，重新运行构建命令：

eas build --platform android --profile development

额外建议 #

• 项目初期就统一文件名命名规范，避免大小写混用；
• 提交代码前，用上述Git命令检查一遍，确保没有大小写不一致的文件。

内容的提问来源于stack exchange，提问作者Joshua Vincent Padilla