Composer安装失败主因是环境依赖缺失，如PHP版本低于7.4、缺少curl/wget；依赖冲突需用composer prohibits排查；install还原lock文件，update重解析依赖；私有包须配置repositories、认证及稳定性标记。
Composer 安装失败常见原因和绕过方法
Windows 上双击 Composer-Setup.exe 卡住，或 macOS/Linux 执行安装脚本后提示 curl: command not found，基本是环境缺依赖。不是 Composer 本身有问题，而是它依赖系统级工具链。
- 确保已安装 PHP（运行
php -v能输出版本号，且版本 ≥ 7.4） - Linux/macOS 必须有
curl或wget；macOS 若用 Homebrew 安装过 PHP，通常自带curl，但可能没加到$PATH - Windows 用户如果用 XAMPP/MAMP，要确认控制台启动的是系统 PATH 下的 PHP，而不是套件自带的、未暴露在命令行中的那个
- 跳过图形安装器，直接用命令行安装更可控：
php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"，再校验哈希（官网会提供最新 SHA384），最后php composer-setup.php --install-dir=/usr/local/bin --filename=composer
用 composer require 添加包时为什么总报错？
最常遇到的是 Your requirements could not be resolved —— 这不是网络问题，是依赖冲突。Composer 不是“下载工具”，它是带约束求解器的依赖管理器，会严格检查 PHP 版本、扩展、其他已装包的版本范围。
- 先看错误里提到的冲突包名，比如
guzzlehttp/guzzle，再运行composer show guzzlehttp/guzzle查当前是否已装、装了哪个版本 - 检查
composer.json里的"require"段有没有写死不兼容的版本，例如"php": "^8.0"但本地是 PHP 7.4 - 临时放宽约束可加
--with-all-dependencies，但别长期这么用；更稳妥的是用composer prohibits guzzlehttp/guzzle:7.5查谁在阻止升级 - 有些包（如
laravel/framework）强制要求特定ext-*扩展，报错里若出现The requested PHP extension ext-intl * is missing，就得去 php.ini 开对应扩展
composer install 和 composer update 到底该用哪个？
项目协作中混用这两个命令是线上事故高发点。composer install 读 composer.lock 精确还原依赖树；composer update 忽略 lock 文件，按 composer.json 重新解析并升级到满足约束的最新版。
- CI/CD 流水线、生产部署必须用
composer install（且确保composer.lock已提交 Git） - 本地开发想试新版本功能，才用
composer update vendor/package-name精准更新单个包；全量update容易引入 BC Break - 如果删了
vendor又没composer.lock，install会退化成update行为 —— 所以永远别把composer.lock加进.gitignore - PHP 版本升级后，必须跑一次
composer update --lock更新 lock 文件里的 PHP 兼容性标记，否则旧 lock 可能拒绝安装新版依赖
私有包怎么用 Composer 加载？
公司内部 SDK 或封装的组件，不能直接 require packagist.org 上的公开包，得告诉 Composer 去哪找源。不是改 repositories 就完事，认证和稳定性标记漏一个就拉不下来。
立即学习“PHP免费学习笔记（深入）”；
- Git 仓库方式最常用：在
composer.json里加"repositories": [{"type": "vcs", "url": "https://gitlab.example.com/myorg/sdk"}] - 如果仓库需要 token 认证，得提前执行
composer config gitlab-token.gitlab.example.com your_personal_token，否则 clone 时 401 - 私有包的
composer.json里必须设"minimum-stability": "stable"或显式标"version": "1.2.3"，否则 Composer 默认只认stable包，dev 分支或无 version 字段的会直接忽略 - 别用
path类型仓库做长期方案——它绕过版本约束，本地改了代码，别人install时不会同步，协作时极易出错
事情说清了就结束
