Linux下Composer自动加载因文件系统大小写敏感而报错：类名、命名空间、文件路径三者大小写必须完全一致；git默认忽略大小写变更易致协作问题；需统一规范并用Linux容器验证。
Linux 下 Composer 自动加载类名与文件名大小写不一致会报错
Composer 的自动加载（尤其是 psr-4 和 classmap）依赖文件系统真实路径。Linux 文件系统默认大小写敏感，如果 src/Utils/Helper.php 里定义了类 Helper，但你在代码中写了 new helper() 或 use Utils\helper;，PHP 会找不到类——因为类名和命名空间中的大小写必须与文件路径、文件内 class 声明完全一致。
常见错误现象：Class 'App\utils\config' not found（实际文件是 src/Utils/Config.php），或 Warning: require(...): failed to open stream。
- 检查
composer.json中autoload配置的命名空间前缀是否与目录结构大小写完全匹配，例如"App\\": "src/App/"对应的是src/App/目录，不是src/app/ - 运行
composer dump-autoload -o后，打开vendor/composer/autoload_psr4.php，确认生成的映射键（如'App\\' => array($baseDir . '/src/App')）路径大小写与磁盘一致 - IDE 重命名类或移动文件时，务必同步改文件名（比如从
User.php改成user.php），否则 Linux 下文件仍存在但 Composer 不认
git 在 Linux 上忽略大小写变更导致协作出问题
Git 默认在 Linux/macOS 下对文件名大小写变化不敏感（除非显式开启 core.ignorecase = false）。这会导致：你本地把 Helper.php 改成 helper.php，git status 看不到变化；推送到远程后，其他人在 Linux 下执行 git checkout 可能直接丢失该文件，或自动加载失败。
- 立即检查当前仓库行为：
git config core.ignorecase—— 若输出true，说明 git 认为大小写无关，需修正 - 临时修复（推荐）：
git config core.ignorecase false，然后手动删掉旧文件、提交新文件名：git rm --cached Helper.php && git add helper.php - 团队统一规范：在项目根目录加
.gitattributes，写入* text=auto eol=lf并配合 pre-commit 检查文件名是否符合 PascalCase / kebab-case 约定
composer install/update 时 vendor 目录下大小写混乱引发 autoload 失败
某些包的 composer.json 中声明的 autoload 路径大小写不规范（比如写成 "Foo\Bar\": "src/foo/bar"），而其实际文件结构是 src/Foo/Bar/。在 Windows/macOS 开发时可能“恰好能跑”，但部署到 Linux 就报 Class not found。
- 不要依赖“本地能跑就没事”——用
docker run --rm -v $(pwd):/app -w /app php:8.2-cli composer install在 Linux 容器里验证 - 检查第三方包源码：进入
vendor/some/package/，运行find . -name "*.php" | grep -i "class.*foo"，比对类名、文件路径、composer.json autoload 三者大小写 - 若无法修改上游，可用
autoload-dev+files手动引入关键小文件，绕过 PSR-4 映射
PHP 命名空间和 use 语句本身不区分大小写，但文件系统区分
use App\utils\Config; 在语法上合法（PHP 解析器不报错），但如果 Config.php 实际在 src/Utils/Config.php，而 utils 目录名是小写，Linux 下就会 require 失败——因为 require 最终落到 src/utils/Config.php 这个不存在的路径。
- PHP 的
use和class关键字不区分大小写，但 Composer 的 PSR-4 映射是字符串前缀匹配 + 文件系统路径拼接，全程区分大小写 - 别依赖 IDE 自动补全的大小写——它可能按你输入习惯生成
use app\services\UserService;，但目录实际叫src/App/Services/ - CI 流程中加一步校验：
find src -name "*.php" -exec php -l {} \; 2>/dev/null | grep -q "syntax error" || echo "PHP syntax OK"不够，还得加composer dump-autoload -n && php -r "require 'vendor/autoload.php';"确保能真正加载
最易被忽略的一点：composer.lock 里记录的是包的 zip 包解压路径，而 zip 格式本身在元数据中保存了原始文件名大小写。如果你用不同平台反复生成 lock 文件，可能导致同一 commit 下 vendor 内容不一致——建议所有成员统一用 Linux 容器生成 lock 文件并提交。
