composer diagnose 是 Composer 自带的诊断工具，用于检查项目环境和配置风险，如权限、网络、PHP 扩展等；默认运行标准检查，支持 -v 查看详情，需优先处理 ERROR 级报错。
composer diagnose 是 Composer 自带的诊断工具，能快速检查项目环境和配置是否符合正常运行要求。它不修复问题，但会清晰列出潜在风险，比如权限错误、网络设置异常、PHP 配置缺陷等，帮你提前避开安装或更新失败的坑。
基础用法：运行诊断检查
在项目根目录（含 composer.json 的文件夹）中执行：
composer diagnose
默认会运行一组标准检查，包括：
- Composer 是否为最新稳定版
- 当前 PHP 版本是否满足 Composer 自身及项目 require 的最低要求
- composer.json 文件是否语法合法（JSON 格式正确、无多余逗号等）
- vendor 目录是否存在且可写（影响 install/update）
- git 是否可用（影响从 VCS 安装包）
- HTTPS 流量是否被代理或 CA 证书异常（常见于企业内网或 macOS 更新后）
启用更严格的检查
加 --verbose 或 -v 可显示详细日志，尤其对 HTTPS 和 DNS 检查有帮助：
composer diagnose -v
若想跳过某些非关键项（比如不关心 git），可用 --no-interaction 配合排除，但更常用的是手动忽略特定警告——只要不是 ERROR 级别，多数 WARNING 可结合项目实际判断是否需处理。
常见报错与对应建议
诊断结果中重点关注标为 ERROR 的条目，典型情况有：
- "The openssl extension is missing" → 确认 php.ini 中已启用 extension=openssl，重启 PHP 服务后重试
-
"The json extension is missing" → PHP 编译时未包含 json，或该扩展被注释，需启用并验证
php -m | grep json -
"curl error: SSL certificate problem" → 说明 CA 证书路径不对，可运行
composer config -g cafile /path/to/cacert.pem设置，或临时用composer config -g secure-http false（仅调试，勿用于生产） -
"vendor is not writable" → 检查目录权限（Linux/macOS 用
ls -ld vendor），必要时执行chmod u+w vendor或改用当前用户拥有该目录
配合全局配置排查
如果在多个项目都报同样问题（如始终连不上 packagist），可能是全局配置异常。可查看：
composer config -g --list
重点检查 github-oauth、cafile、secure-http 等设置是否合理。误配的代理或镜像源（如过期的国内镜像地址）也会导致 diagnose 显示网络类 ERROR。
基本上就这些。diagnose 不复杂但容易忽略，建议每次新建项目或更换开发环境后顺手跑一次，省去后续一堆“为什么 install 失败”的排查时间。
