composer diagnose仅检查Composer自身运行所需的最小PHP环境闭环，如openssl、zlib、phar等扩展是否启用，composer.json格式是否合法，vendor/目录是否可写；不检测网络连通性、镜像可用性、DNS解析、HTTPS证书、代理设置及依赖安装能力。
Composer 本身没有内置的“环境健康检测”命令，但可通过组合诊断命令 + 镜像配置验证，快速定位常见环境问题（如网络、PHP 扩展、权限、镜像失效）。
composer diagnose 能查什么、不能查什么
composer diagnose 是最接近“健康检查”的官方命令，但它只验证 Composer 自身运行前提，不检测网络连通性或镜像可用性。
- ✅ 检查
openssl、zlib、phar等必需 PHP 扩展是否启用 - ✅ 验证
composer.json格式是否合法（仅当前目录下存在时） - ✅ 检测
vendor/目录是否被意外写入（防止误提交） - ❌ 不测试能否访问 packagist.org 或你配置的镜像源
- ❌ 不检查 DNS 解析、HTTPS 证书、代理设置等网络层问题
执行后若输出 OK，仅代表 Composer 运行环境基础就绪；若失败，优先看第一行错误提示，比如 The openssl extension is missing 就直接去开扩展。
如何验证镜像是否真正生效且可用
很多人配了阿里云或腾讯云镜像却没生效，或者镜像本身已不可用（如旧版 https://packagist.phpcomposer.com 已停服），必须手动验证。
- 先确认当前镜像：运行
composer config -g repo.packagist，应返回类似{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} - 再实测连通性：用
curl -I https://mirrors.aliyun.com/composer/packages.json，HTTP 状态码为200才算通；若超时或返回404，说明镜像地址过期或网络不通 - 注意：某些企业网络会拦截非标准端口或 HTTPS SNI，可加
-v参数看 curl 是否卡在 TLS 握手阶段
如果 composer config -g repo.packagist 输出为空，说明全局镜像未设置——别只改项目级配置（composer config repo.packagist ... 不加 -g），那对全局命令无效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
composer update/install 卡住时的三步排查法
卡在 Downloading https://mirrors.xxx.com/... 或 Resolving dependencies 不动，大概率不是 Composer bug，而是环境链路某环断裂。
- 第一步：关掉所有代理软件（Clash、Surge、SwitchyOmega），Composer 默认不读系统代理，但某些终端环境会透传
http_proxy变量，导致请求发到错误地址 - 第二步：临时切回官方源测试：运行
composer config -g repo.packagist https://packagist.org，再试composer clear-cache && composer install --no-plugins；若成功，基本锁定镜像或网络问题 - 第三步：检查 DNS——在终端执行
nslookup mirrors.aliyun.com，若无响应或返回内网 IP，说明本地 DNS 污染或策略拦截，可临时换为114.114.114.114测试
特别注意：composer install 卡在 Resolving dependencies 时，90% 是因为 composer.lock 里记录了某个包的版本在当前镜像中不存在（例如 lock 文件来自国外 CI，而国内镜像尚未同步该 tag），此时需删 lock 文件重生成，或换源后运行 composer update --lock。
PHP 版本与扩展兼容性是隐藏雷区
Composer 2.5+ 要求 PHP ≥ 7.4，但更隐蔽的问题是扩展版本冲突：比如 mbstring 编译时未启用 --enable-zip，会导致解压失败却只报模糊错误 Failed to extract xxx: unable to decompress...。
- 运行
php -m确认openssl、mbstring、json、phar、zlib、curl全部在列 - 检查
php -i | grep -E "(openssl|zlib|mbstring)"，重点看OpenSSL support => enabled和zlib.version是否 ≥ 1.2.11（旧 zlib 在 HTTPS 响应流处理上易出错） - Windows 用户注意：PHP 官方 Windows 包默认不含
curl扩展，需手动取消php.ini中;extension=php_curl.dll的注释，并确保libssh2.dll在系统 PATH 中
这些细节不会出现在 composer diagnose 报告里，但一旦缺失，就会在下载包、校验签名、解压归档等环节随机崩，错误信息往往指向具体包而非根本原因。
