composer --version 报 command not found 是因未加入 PATH：Mac/Linux 需 sudo mv composer.phar /usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer；Windows 需重启终端或手动添加 Composer 安装目录到系统 PATH。
composer 不是 PHP 内置命令，2026 年仍需单独安装；它在 PHP 8.2+ 环境下报错频发，主因不是工具旧，而是锁文件里记录的包不兼容新 PHP 版本或缺失扩展——比如 ext-gd、ext-mbstring 没启用，或某个依赖还在用已被废弃的 mysql_connect()。
composer --version 报 command not found 怎么办
这不是没装，是 shell 找不到可执行文件。Mac/Linux 下常见于用 php composer.phar 下载后没加权限也没软链；Windows 下则是安装器勾了 “Add to PATH” 但终端没重启，或 PATH 实际指向了旧 PHP 目录下的 composer.bat。
- 先运行
which composer（Mac/Linux）或where composer（Windows），为空就确认没注册进 PATH - Mac/Linux：把
composer.phar放到/usr/local/bin/composer后，补一句sudo chmod +x /usr/local/bin/composer - Windows：重开 CMD/PowerShell，再跑
composer --version；若还不行，手动把 Composer 安装目录（如C:ProgramDataComposerSetupin）加进系统环境变量 PATH - 别用
php composer.phar --version代替验证——它能跑，不代表composer命令可用
composer install 报 “Your requirements could not be resolved”
这错误和网络无关，是环境与 composer.lock 不匹配。2026 年很多老项目锁文件还写着 "php": "^7.4"，而你本地是 PHP 8.2，Composer 直接拒绝解析。
- 先看报错末尾有没有类似
ext-gd * -> it is missing from your system的提示，缺扩展就去php.ini开启对应extension=行 - 检查
php -v和composer.json里的"require": {"php": "..."}是否冲突；不一致就升级 PHP 或删掉composer.lock再试（仅限开发环境） - 有现成
composer.lock就必须用composer install，别手欠跑composer update——后者会无视锁文件重算依赖，大概率崩 - 共享主机上如果卡在
proc_open()，说明被禁用了，只能本地装好，连同vendor/和composer.lock一起上传
想升级依赖但不敢动全量 update
composer update 在 2026 年仍是“高危操作”，尤其当你项目里混着 Laravel 9 和 Symfony 5 这类已停止维护的版本时，一次 update 可能拉进一堆 PHP 8.2 不兼容的 dev-only 包。
- 只升一个包：
composer update monolog/monolog，不会动其他依赖 - 查谁在挡路：
composer prohibits guzzlehttp/guzzle:7.9，它会列出所有阻止该版本安装的已装包 - 先预演不落地：
composer update --dry-run，看控制台打印的变更计划，再git status对比composer.lock差异 - 国内用户务必配阿里云镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，否则update极易超时中断
autoload 配了但类还是找不到
90% 是路径写错或命名空间没对齐。vendor/autoload.php 只负责加载第三方包；你自己写的类要被自动引入，必须靠 composer.json 里的 autoload 字段声明规则。
- PSR-4 映射示例：
"autoload": {"psr-4": {"App\": "src/"}}，意味着AppHttpControllersHomeController必须放在src/Http/Controllers/HomeController.php - 如果类文件在
helpers.php这种纯函数文件里，得用"files": ["helpers.php"]，且路径是相对于composer.json的 - 改完 autoload 一定要跑
composer dump-autoload，否则不会生效 - 别在
vendor/里手动增删文件——composer install会把它全清掉
最常被忽略的一点：2026 年很多包已弃用 monolog/monolog 这类旧命名，转而用 monolog/monolog 的 v3 分支，但其最低 PHP 要求是 8.1；如果你的 composer.json 还锁着 "^2.0"，composer update 就永远卡在“无法满足约束”。得先看清报错里具体哪一行约束冲突，再决定是升 PHP、换包，还是硬指定 composer require monolog/monolog:^3.0 --with-all-dependencies。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
