报错“Installation failed, reverting ./composer.json”是Composer回滚动作，真正原因需查看其上方红色错误日志；常见根源包括PHP版本/扩展不匹配、依赖冲突、镜像失效、网络问题或composer.lock残留旧源地址，应优先运行composer install -vvv捕获完整日志并针对性排查。
报错信息只显示“Installation failed, reverting ./composer.json”怎么办
这行提示不是错误本身，而是 Composer 的兜底动作——它已经失败了，正在回滚。真正的问题藏在它上面几行的红色输出里。别跳过那些看起来像乱码的堆栈或警告，它们才是关键。
- 终端输出默认只保留最近几百行，如果安装过程长，得用
composer install -vvv 2>&1 | tee install.log把完整日志落地，再翻顶部 - 重点关注以
Fatal error:、ParseError:、Class not found:开头的行，这类是 PHP 解析或运行时真崩溃，-vvv才会暴露完整上下文 - 如果只看到
file could not be downloaded或卡在Loading composer repositories，说明问题出在元数据拉取阶段，和项目代码无关，先别碰composer.json
怎么确认是不是镜像没生效，而不是网络或权限问题
Composer 静默 fallback 是最常见误判来源。你以为切了阿里云源，其实它还在连 packagist.org，只是不告诉你。
Discussion Composer
下载
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 运行
composer install -vvv 2>&1 | head -n 10 | grep Downloading，第一行 URL 就是真实请求地址；如果看到的是https://packagist.org/或https://repo.packagist.org/，说明镜像完全没走 - 检查项目根目录
composer.json是否含"repositories"字段：哪怕只是"repositories": []，也会屏蔽全局配置，此时composer config -g repo.packagist输出再漂亮也没用 - 执行
composer config repo.packagist（不加-g），看是否返回你配的镜像地址；若返回空或默认值，说明项目级配置被覆盖或未写入
vendor/autoload.php 无法加载或 Class not found 怎么快速定位
这类报错表面是自动加载失败，根源往往是安装中途中断导致文件不全，或 autoloader 生成逻辑被破坏。
- 先验证
vendor/autoload.php文件是否存在且可读：ls -l vendor/autoload.php；如果不存在，说明install根本没完成，别急着查 PSR-4 映射 - 运行
php -f vendor/autoload.php，看是否直接报语法错误——某些镜像返回 HTML 页面（如人机验证）会导致该文件写入乱码，删掉vendor/和composer.lock再重试 - 检查
composer.json中"autoload"和"autoload-dev"是否引用了不存在的路径，比如"files": ["src/helpers.php"]但该文件已被删除
报错里出现 file_put_contents(): Only variables should be passed by reference 怎么办
这不是你代码写错了，是 Composer 拿到了一个带 BOM 头或 HTML 内容的响应体，当成 JSON 解析后传给 PHP 函数，触发了严格模式报错。
- 该错误 95% 出现在使用了失效镜像（如某些教育网镜像或已下线的源）时，
curl拿到的是 302 跳转页或验证码页面，而非packages.json - 手动验证镜像可用性：
curl -I https://mirrors.aliyun.com/composer/packages.json，必须返回HTTP/2 200；若返回HTTP/1.1 302或内容含<html>，立刻换源 - Windows 用户注意：BOM 头可能让
composer.lock解析失败，删掉它比修编码更省事
composer.lock 里硬编码的 provider 地址。换镜像后不清它，Composer 就会执着地去旧域名上找包，反复失败却不提示——这个文件不是“记录”，而是“指令”。 
