Composer装完但跑不起来，主因是PHP环境（≥8.0且启用openssl/zlib/json/mbstring）、PATH路径、阿里云镜像未配置或autoload.php未用__DIR__绝对路径引入；务必执行composer diagnose验证。
Composer 不是装完 composer --version 显示数字就万事大吉的工具——90% 的“装了但跑不起来”问题，都卡在 PHP 环境、路径、镜像或 autoload.php 引入方式这四点上。
PHP 版本和扩展没对齐，composer install 会静默失败
常见错误现象：Could not open input file: composer.phar（实际是 PHP 解析器不兼容）、Failed to decode response（缺 openssl 或 zlib）、Your requirements could not be resolved（PHP 版本低于 composer.lock 中声明的最低要求）。
- Composer 2.5+ 要求 PHP ≥ 8.0，且必须启用
openssl、zlib、json、mbstring四个扩展——缺一不可 - 验证命令必须按顺序执行：
php -v（确认含NTS且版本 ≥ 8.0）、php -m | grep -E "(openssl|zlib|json|mbstring)" - Windows 下用 PHPStudy/XAMPP 时，
php -v和composer --version可能调用不同 PHP，唯一可信检查是composer diagnose
vendor/autoload.php 必须用 __DIR__ 引入，不能写相对路径
错误写法：require './vendor/autoload.php'; 或 require 'vendor/autoload.php'; —— 一旦通过 CLI 执行、Nginx 配置别名、或被其他文件 include，立刻报 Class not found。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 所有入口文件（
index.php、cli.php、phpunit启动脚本）第一行且仅此一行，必须是：require __DIR__ . '/vendor/autoload.php'; - 不能有任何输出（包括
session_start()、echo、BOM 字节）在这行之前，否则自动加载注册失败 - 老项目无命名空间？别硬改代码，改
composer.json的"autoload": {"classmap": ["lib/", "includes/"]}，再跑composer dump-autoload
国内网络下 composer install 卡住，本质是镜像没切对
卡在 Loading composer repositories 或 Downloading https://packagist.org/packages.json，不是网速慢，是直连 packagist.org 被墙。
- 全局配置阿里云镜像（推荐）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目级配置（适合多源协作）：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 切完镜像后务必运行
composer diagnose，确认Repo packagist is using the default value已消失，且HTTP proxy和CA bundle检查通过 - PHPStudy 用户注意：若
diagnose报SSL certificate problem，需打开 PHP 配置，取消注释并修正curl.cainfo指向正确的 CA 文件路径
composer install 和 composer update 混用，线上环境必崩
团队里有人偷偷 update 并提交新 composer.lock，其他人 install 出来行为不一致，却查不出原因——这是最隐蔽也最致命的坑。
-
composer install：只读composer.lock，还原完全一致的依赖树 → 适用于git clone、CI/CD、线上部署 -
composer update：忽略lock，重新解析composer.json→ 仅用于本地开发加依赖或升级小版本 - 加新包必须用
composer require monolog/monolog:^3.0（带^），它会自动update并更新lock；别手动update后再require - CI/CD 流水线里禁止出现
composer update，哪怕加了--no-dev—— 锁文件才是环境契约
真正难的不是命令怎么敲，而是每次执行前想清楚：当前环境是否匹配 composer.lock 里的 PHP 版本和扩展？入口文件第一行是不是绝对路径引入？镜像源有没有生效？这三个判断比记住所有参数更重要。
