Composer install报错八成是环境配置错误，需依次验证PATH（含composer.bat路径）、PHP CLI可用性、必需扩展（openssl/curl/mbstring等）、镜像URL末尾斜杠及权限归属，每步须用对应命令实测生效。
Composer install 报错，八成不是代码或包的问题，而是环境没配对——PATH、PHP CLI、扩展、镜像配置、权限这五处只要有一处错，composer install 就会静默失败或卡在奇怪位置。
composer 命令找不到？先盯死 PATH 和 PHP CLI
报 command not found: composer，本质是系统根本没找到 composer.bat（Windows）或 composer 可执行文件（Linux/macOS）。
- Windows：确认
%PROGRAMDATA%\ComposerSetup\bin已加入「系统变量」→Path，且只加目录，不加文件名；改完必须关掉所有终端重开 - Linux/macOS：运行
sudo mv composer.phar /usr/local/bin/composer && sudo chmod +x /usr/local/bin/composer，再验证composer --version - 更隐蔽的坑：
php -v必须有输出，否则composer根本起不来；若报错，说明 PHP CLI 未就绪，别急着装 Composer - 宝塔或 Docker 环境中，注意 CLI 使用的 PHP 路径可能和 Web 不同，用
which php和php -v双重确认
卡在 “Resolving dependencies” 或报 SSL/cURL 错误？PHP 扩展没启全
这类卡顿或 cURL error 60、certificate verify failed 不是网络问题，是 PHP 缺关键扩展或 CA 证书路径错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 必须启用的扩展：
openssl、curl、mbstring、json、zip；运行php -m | grep -E "openssl|curl|mbstring"验证 - Windows 用户：打开
php --ini显示的php.ini，取消extension=openssl等行前的分号，确保extension_dir指向正确 - CA 证书失效常见于 Docker 或旧 CentOS；运行
php -r "print_r(openssl_get_cert_locations());"查default_cert_file，若为空或路径不存在，需手动下载cacert.pem并在php.ini中设curl.cainfo和openssl.cafile
换源后仍连 packagist.org？镜像配置三要素缺一不可
composer config -g repo.packagist 看起来成功，但 composer install -vvv 仍请求官方域名——说明镜像根本没生效。
- 键名必须是
repo.packagist（单数，不能是repos.packagist或repositories） - 第二个参数必须是
composer（type 值），漏掉则新版 Composer 直接忽略 URL - URL 必须以
/结尾：https://mirrors.aliyun.com/composer/✅，https://mirrors.aliyun.com/composer❌（少斜杠会导致拼出非法路径） - 验证方式：运行
composer config -g repo.packagist，输出必须是完整 JSON，如{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；空、null或仍是官方地址，说明没写进去
Permission denied 写 vendor/ 或 composer.lock？归属权被 sudo 污染了
报错里带具体路径，比如 file_put_contents(/path/to/vendor/autoload.php): Permission denied，问题一定在那个目录的属主上。
- 立刻执行
ls -ld /path/to/vendor；如果属主是root，而你是普通用户，就必然失败 - 修复命令：
sudo chown -R $USER:$USER /path/to/vendor /path/to/composer.lock（别用chmod 777，那是安全隐患） - 宝塔用户特别注意：你在终端用
root配的全局镜像，但实际运行的是www用户，得用sudo -u www composer config -g repo.packagist ... - CI/CD 流水线中，确保
COMPOSER_HOME（如~/.composer）对运行用户可读写
环境配置错误最麻烦的地方在于：它不报明确错误，只让命令卡住、跳过、或静默走错路。每一步都要用对应命令验证真实状态，而不是“我以为配好了”。
