Linux/macOS下Class not found而Windows能跑，是因文件系统大小写敏感性暴露了路径、命名空间与类名三者不一致；需检查autoload_psr4.php映射、composer.json配置（如"App\": "app/"）、磁盘路径、namespace声明及文件名是否逐字节匹配。
Linux/macOS 下 Class not found，Windows 却能跑？不是 Composer 有 bug，是文件系统大小写敏感性暴露了路径、命名空间、类名三者不一致。
检查 vendor/composer/autoload_psr4.php 里有没有你的命名空间
运行 composer dump-autoload -v 后，直接打开 vendor/composer/autoload_psr4.php，用 Ctrl+F 搜索你的命名空间前缀（比如 'App'）。如果搜不到，说明 PSR-4 映射根本没生效——不是类写错了，是 composer.json 里那行配置被 Composer 忽略了。
-
"autoload"键写在了scripts或config下，Composer 直接跳过 - 命名空间末尾漏了双反斜杠：
"App": "app/"❌ 应为"App\": "app/"✅（JSON 解析后"App"变成无尾缀字符串，PSR-4 匹配失败） - 路径用了
./app/或绝对路径，PSR-4 只接受项目根目录下的相对路径，且末尾必须带/ - 该目录被
.gitignore忽略了（如app/在忽略列表里），dump-autoload默认跳过被忽略路径
验证磁盘路径、namespace 声明、类文件名是否逐字节一致
Linux 文件系统区分大小写，而 Windows 默认不区分。你本地 src/utils/Helper.php 能加载，不代表线上也能跑。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 终端执行
ls -l src/Utils/Helper.php，确认真实路径拼写（注意大小写和斜杠方向） - 打开该文件，检查
namespace是否与目录结构完全对应（namespace AppHttpControllers;→ 路径必须是app/Http/Controllers/，不能是app/http/controllers/） - 类名必须和文件名完全一致：
class UserController→ 文件必须叫UserController.php，不是usercontroller.php或UserControllerController.php - IDE 重命名类时，务必同步改文件名；否则 Git 在 Linux 下可能根本不记录变更（
core.ignorecase = true是默认行为）
files 自动加载路径错一个字母就失败
"files" 字段是硬路径直引，不走任何映射逻辑，也不做大小写容错。写成 "App/Helpers/Helper.php"，但磁盘上实际是 app/Helpers/Helper.php，composer dump-autoload 阶段就会直接报：Failed to open stream: No such file or directory。
- 用
ls -l app/Helpers/Helper.php确认路径存在且大小写准确 - 路径必须是相对于项目根目录的，且不能含
./或绝对路径 - 修改
composer.json后，必须重新执行composer dump-autoload，否则变更不会生效 - 建议统一用小写路径（如
app/Helpers/Helper.php），符合 Laravel 社区惯例，也降低跨平台风险
Git 忽略大小写变更导致协作失效
你把 Helper.php 改成 helper.php，git status 可能完全没反应——因为 Git 认为这只是大小写变化，默认不追踪。协作者 git pull 后，文件直接消失或加载失败。
- 立即检查：
git config core.ignorecase，若输出true，说明当前仓库已关闭大小写敏感 - 临时修复：
git config core.ignorecase false，然后git rm --cached Helper.php && git add helper.php - 团队长期方案：项目根目录加
.gitattributes，写入* text=auto eol=lf，并配合 pre-commit 脚本检查文件名是否符合 PascalCase - CI/CD 中必须用 Linux 容器验证自动加载，别信“本地能跑就没事”
最麻烦的不是改错，而是改完忘了 composer dump-autoload -o；最容易被忽略的是 core.ignorecase 的默认值，它让问题只在部署那一刻爆发。
