Composer install 报错找不到 composer.json，首要原因是未在含该文件的项目根目录执行命令；需用 ls/dir 确认文件存在、检查大小写与路径，排除子目录或父级误操作。
composer install 报错说找不到 composer.json？先确认当前目录
不是配置文件损坏，而是根本没在项目根目录下执行命令。Composer 所有操作都依赖当前工作目录是否存在 composer.json，它不会向上递归查找，也不会自动识别子目录里的项目。
常见现象：composer install 直接报错 Could not find composer.json 或 No composer.json found，但你确信“明明有”。大概率是你 cd 进错了目录——比如在 src/、public/ 或父级空文件夹里运行了命令。
- 用
ls -la（Linux/macOS）或dir（Windows）确认当前目录下是否真有composer.json文件（注意大小写，Windows 不敏感但 Linux 敏感） - 别依赖 IDE 的“终端打开位置”，手动
cd到含composer.json的那一层目录再试 - 如果项目是从 Git 克隆的，检查是否漏掉了
--recursive或子模块未初始化，导致composer.json被藏在 submodule 里没拉下来
composer.json 存在但 install 仍失败？检查文件权限和编码
composer.json 文件存在 ≠ Composer 能读取它。Windows 中文用户名、Git 自动换行、编辑器保存 BOM 头，都会让 PHP 解析失败，报错可能表现为 JSON decode error 或静默跳过依赖解析。
- 用
php -r "json_decode(file_get_contents('composer.json')) || die(json_last_error_msg());"直接验证 JSON 合法性；PHP 8.0+ 会附带偏移量，精准定位非法字符位置 - 用编辑器开启「显示不可见字符」，检查是否有全角引号、中文冒号、末尾逗号、UTF-8 BOM（EF BB BF）或零宽空格（U+200B）
- Linux/macOS 下运行
file composer.json看编码，若输出含with CRLF line terminators，说明是 Windows 换行，用dos2unix composer.json修复
全局配置缺失导致 install 卡在 “Loading repositories”？别只看项目目录
报错不提 composer.json，但卡在 Loading composer repositories 或反复重试 packagist.org，往往不是项目缺配置，而是全局镜像没配好，或被残留缓存干扰。
- 运行
composer config -g repo.packagist，输出必须是类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或报错，说明全局镜像根本没写进去 - 删掉
composer.lock和vendor/——composer.lock里硬编码了旧源地址，不清它，install 就永远重试失败路径 - 执行
composer clear-cache；Windows 用户还需手动删%LOCALAPPDATA%\Composer\cache - 验证镜像可用性：
curl -I https://mirrors.aliyun.com/composer/packages.json必须返回HTTP/2 200，若返回 HTML 页面（如人机验证），说明该镜像不适合 CLI 场景
CI/CD 或多用户环境里配置“看似生效”实则失效？查清实际运行用户
你在 root 下配了镜像，但 Jenkins 或宝塔用 www 用户跑构建，结果 composer install 还是直连 packagist.org。这不是配置问题，是配置根本没被读到。
- 在构建脚本开头加
whoami和echo $COMPOSER_HOME（Linux/macOS）或echo %USERNAME%+echo %COMPOSER_HOME%（Windows），确认运行身份和配置路径 - 别用
sudo composer config -g配置，那会把配置写进 root 的COMPOSER_HOME；改用sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 检查项目级是否覆盖：进入项目目录后运行
composer config repo.packagist，如果输出非空，说明composer.json里写了"repositories"字段，它会完全屏蔽全局镜像
composer.json 明明存在却因编码、权限或路径语义被 PHP 底层函数拒绝读取，而不是内容写错了。验证要落到具体命令输出，别信“看起来应该没问题”。 
