composer 报错或卡顿的根源在于环境配置错误：path未配置、php cli不可用、必要扩展缺失、镜像配置不规范（键名/类型/结尾斜杠）、依赖约束过宽、用户权限错配、或proc_open()/putenv()被禁用。
装完 Composer 却 composer --version 报错，或者 composer install 卡在 “Loading composer repositories” 几分钟不动——不是你网不好，是环境没配对、镜像没生效，或关键函数被禁用了。
composer 命令找不到？先盯死 PATH 和 PHP CLI
Windows 上双击 Composer-Setup.exe 没勾 “Add to PATH”，或 Linux/macOS 没把 composer.phar 移到 /usr/local/bin/composer 并加执行权限，就会直接报 “command not found”。更隐蔽的是：PHP 本身不可用。
- 必须先运行
php -v，有输出才算 PHP CLI 就绪；若报错，composer根本启动不了 - Windows 用户常见路径含空格或中文（如
C:\Program Files\php），会导致proc_open()调用失败，建议改用C:\php82这类纯英文短路径 - Linux/macOS（尤其宝塔）要注意：面板里 PHP 是
/www/server/php/82/bin/php，但终端默认可能是系统自带的老版本，得手动建软链：ln -sf /www/server/php/82/bin/php /usr/local/bin/php - 验证完
php -v，再跑php -m | grep -E "openssl|mbstring"，缺openssl或mbstring扩展，composer会静默失败
镜像配置写错就等于没配：repo.packagist 必须带 type 和斜杠
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ 这条命令，漏一个字符就白干。它不是“大概能用”，而是严格校验三要素。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 键名必须是
repo.packagist，不是repos.packagist（多 s）、packagist.org（少 repo.）或repository（完全不对） - 第二个参数
composer是type值，不能省；漏掉后新版 Composer 直接忽略 URL，回退到官方源 - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠在 Composer 2.2+ 会 404 或静默失效） - 验证是否成功：运行
composer config -g repo.packagist，输出必须是完整 JSON，例如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；如果输出null或还是https://repo.packagist.org，说明根本没写进去
装了镜像还卡在 Resolving dependencies？那是依赖树爆炸，不是网络问题
换源只加速下载（Downloading、Fetching package），不解决依赖解析慢。如果你 composer install -vvv 看到卡在 Resolving dependencies 超 10 秒，基本是约束太松导致求解器穷举所有组合。
- 检查
composer.json里有没有"*"或"^1.0 || ^2.0"这类宽泛版本号，改成锁死小版本，比如"monolog/monolog": "2.12.0" - 删掉
require-dev里非必要的大包（如phpstan/phpstan、infection/infection），它们会极大拖慢解析 - 确认没启用已废弃的
fxp/composer-asset-plugin（老 Yii2 项目常见），它会额外请求 Bower/NPM 源，而这些源国内无镜像，直接卡死 - 临时提速可加
--no-cache或清缓存：composer clear-cache，但根源还在约束收紧
宝塔/CI/计划任务里镜像不生效？用户权限和配置作用域搞错了
你在终端用 root 用户执行了 composer config -g，但宝塔的「一键部署」或 Jenkins 的构建任务是以 www 或 jenkins 用户运行的——它读不到 /root/.composer/config.json。
- 宝塔环境下，
whoami查当前执行用户，然后用该用户身份重跑镜像配置：sudo -u www composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 更稳妥的做法是项目级配置：进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），这样无论谁执行、在哪执行，都走这个源 - CI 场景（如 GitHub Actions）建议在
steps中显式配置镜像，避免依赖全局设置；同时注意composer self-update可能因权限失败，优先用预装版本
最常被忽略的其实是 proc_open() 和 putenv() 被禁用——它们不出现在报错信息里，但会让 composer 启动即崩溃，表现为命令无响应或直接退出。检查 php.ini 的 disable_functions，删掉这两项，再重启 PHP 服务，比反复折腾镜像管用得多。
