composer --version仅验证PATH可找到Composer，真实环境需composer diagnose全面检测PHP版本、扩展、证书、缓存及镜像源连通性，配镜像后必须composer clear-cache否则仍走旧源。
composer --version 能执行，只是第一步
它只说明系统 PATH 找到了 composer.bat 或 composer 可执行文件，不等于 PHP 环境、扩展、网络源都正常。很多人卡在后续 composer install 卡住或报错，却以为“已经装好了”。
必须运行 composer diagnose 查真实健康状态
这个命令会一次性检查：PHP 版本是否 ≥ 7.2、openssl/curl/zlib 扩展是否启用、CA 证书是否可信、缓存目录是否可写、以及能否连上当前配置的 Packagist 源（注意：如果你用了阿里云镜像，它连不上 packagist.org 是正常的，关键看 composer config -g repo.packagist 输出是否指向镜像地址）。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果提示
open_basedir restriction in effect，说明 PHP CLI 的php.ini里限制了临时目录，要改open_basedir配置或注释掉 - 如果报
The openssl extension is required，不是重装 Composer，而是去php --ini查到的php.ini里取消extension=openssl前的分号 - 加
-v参数能看到每一步检测详情：composer diagnose -v
composer config -g 和 composer global config bin-dir --absolute 要对得上
全局配置生效与否，不能只信“设过了”，得看实际路径是否被 Composer 认可。比如你设了 COMPOSER_HOME，但 composer config -g home 输出的路径若含 ~ 或 $HOME，说明环境变量写错了——它必须是绝对路径。
- 运行
composer config -g，确认顶部显示的Global configuration file路径是你预期的（如C:\Users\Alice\AppData\Roaming\Composer\config.json） - 运行
composer global config bin-dir --absolute，输出应是类似C:\Users\Alice\AppData\Roaming\Composer\vendor\bin—— 这个路径必须手动加进系统 PATH，否则laravel、phpunit这类全局命令永远找不到 - Windows 用户特别注意：这个
vendor\bin路径要加到「用户变量」的 PATH，不是「系统变量」；加完必须新开终端，echo %PATH%里得能搜到它
国内用户必须验证镜像源是否真在用
配了阿里云镜像却没清缓存，composer install 仍会卡在 Resolving dependencies...。因为旧缓存里还存着官方源的元数据。
- 先查当前源：
composer config -g repo.packagist，应返回https://mirrors.aliyun.com/composer/ - 再强制清空：
composer clear-cache（别跳过这步） - 最后用一个空目录测试：
mkdir test && cd test && composer init -n && composer require monolog/monolog—— 如果 10 秒内开始下载，说明镜像 + 环境全通
COMPOSER_HOME 含相对路径会静默失效，镜像配置不配合 clear-cache 就等于没配。这些点不卡在错误信息里，只卡在你的时间上。 
