Composer命令失败主因是未加入PATH；依赖冲突源于PHP版本或扩展不匹配；升级应限包更新并用--dry-run预览；PHP 8.2+报错多因旧包不兼容，需查清包名并升级或替换。
Composer 命令行执行失败，提示 command not found
根本原因不是 Composer 没装，而是它没进系统 $PATH。Mac/Linux 下常见于用 php -r 方式下载后直接运行，没加执行权限或没软链到全局路径；Windows 则常因安装时勾选了“Add to PATH”但实际没生效（尤其重装过系统或用了 Scoop/Chocolatey）。
- Mac/Linux：检查
which composer，若为空，手动加软链：sudo ln -s /usr/local/bin/composer /usr/local/bin/composer（路径以你实际存放位置为准） - Windows：打开命令提示符运行
where composer，若无结果，重新运行官方安装器，务必勾选 “Add Composer to the system PATH” 并重启终端 - 验证是否真可用：
composer --version，不是php composer.phar --version—— 后者能跑不等于 Composer 已正确安装为全局命令
composer install 报错 “Your requirements could not be resolved”
这不是网络问题，是依赖冲突。Composer 会严格校验 composer.lock 中记录的精确版本与当前环境 PHP 版本、已安装扩展是否匹配。哪怕你只改了一行 composer.json，也别直接 install，先看清楚锁文件来源。
- 如果项目有现成
composer.lock：必须用composer install（不是update），否则会忽略锁文件重算依赖，大概率失败 - 如果本地 PHP 版本低于
composer.lock里要求的最低版本（比如锁文件写的是"php": "^8.1"，而你用的是 8.0），删掉composer.lock再跑composer install也没用——得先升级 PHP - 扩展缺失也会触发此报错：比如
ext-gd被某个包声明为必需，但你的 PHP 没启用，错误信息里通常带ext-gd * -> it is missing from your system
在旧项目中升级依赖，composer update 改动太大怎么办
composer update 默认更新所有包到符合 composer.json 约束的最新版，不是“小步迭代”。生产环境直接这么干，等于把未知风险全塞进一次发布。
- 只更新某一个包：
composer update vendor/package-name（如composer update monolog/monolog） - 锁定 PHP 版本范围不变：加
--with-all-dependencies仍可能升二级依赖，更稳的做法是先composer prohibits vendor/package-name:version查谁在挡路，再针对性处理 - 想试升级但不落地？用
composer update --dry-run看计划变更，配合git status观察composer.lock差异 - 切记：任何
update都会重写composer.lock，提交前确认 diff 合理，尤其注意content-hash和packages下的版本号变动
PHP 8.2+ 下 composer require 报 Declaration of ... must be compatible with ...
这不是你代码写错了，是某些老包（尤其是 2020 年前发布的）的接口定义没适配 PHP 8.2 的类型系统收紧。典型如 psr/log 旧版和新版 Throwable 处理逻辑冲突，或 symfony/console v4 在 PHP 8.2 下反射异常。
立即学习“PHP免费学习笔记（深入）”；
- 先查清具体哪个包触发：错误堆栈最上面几行会指出文件路径，对应到
vendor/下的包名 - 临时解法：加
--ignore-platform-req=php强制装（不推荐长期用） - 根治办法：看该包是否有新版支持 PHP 8.2+，例如
monolog/monologv2.13+ 就修复了；若没有，考虑换包或 fork 后 patch - 预防：新项目初始化时就加
composer create-project指定 PHP 版本约束，比如"config": {"platform": {"php": "8.2.10"}}
依赖管理真正难的不是命令怎么敲，是每次 composer.lock 变动时，得看清哪一行是 PHP 版本卡的，哪一行是扩展缺的，哪一行是别人家的包悄悄改了接口。漏看一个，上线就挂。
