Composer 需匹配 PHP 版本（≥8.0）与扩展（openssl/zlib/json/mbstring），禁用 Git Bash 运行，换阿里云镜像源解决网络问题，勿删 composer.lock，版本号需锁死，autoload 修改后须执行 dump-autoload。
Composer 不是“装上就能用”的工具，它依赖 PHP 环境和网络策略，本地装完却跑不起来 composer install 是最常见失败起点。
PHP 版本和扩展没配对，composer 命令直接报错
Composer 从 2.5 开始最低要求 PHP 8.0，但很多老项目还在用 PHP 7.4，强行升级会触发 ParseError 或 TypeError；反过来，用太旧的 Composer（如 1.x）装新包，又可能因不支持 platform-check 或 lock file version 3 失败。
- 先确认 PHP 版本：
php -v，再查 Composer 官方兼容表（不是看文档首页，要看https://getcomposer.org/doc/00-intro.md#installation-linux-unix-macos底部小字） - 必须启用
openssl、zlib、json、mbstring四个扩展，缺一个就卡在Could not open input file: composer.phar这类假错误里 - Windows 用户注意：别用 Git Bash 直接运行
php composer.phar，它会把路径解析成/c/Users/xxx格式导致找不到autoload.php，改用 PowerShell 或 CMD
composer install 卡住或报 Failed to decode response
这不是 Composer 本身坏了，而是它默认走 packagist.org，国内访问不稳定，DNS 污染、TLS 握手超时、中间代理截断响应都可能导致这个错误——尤其在 CI 环境或公司内网。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 临时解决：加
-vvv参数看卡在哪一步，大概率停在Downloading https://packagist.org/packages.json - 永久方案：换镜像源，但别用网上搜到的过期地址（比如
https://packagist.phpcomposer.com已停服），现在稳定的是阿里云：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 如果项目已有
composer.lock，别轻易删掉重装；install是按 lock 文件精确还原，update才会重新解析依赖树——混用会导致环境不一致
require 的包版本写法不对，composer update 装了不该装的东西
版本号不是越新越好。^2.0 允许升到 2.9.9，但某些包的 2.5.0 引入了 PHP 8.1 特性，你 PHP 8.0 就直接崩；~1.2.3 表示只允许补丁更新，可一旦作者把 1.2.4 写成破坏性更新，照样翻车。
- 生产环境永远用
composer require vendor/name:1.2.3锁死小版本，别留^或~ - 开发时想试新功能，先
composer require vendor/name:dev-main --dev，但得确认对方 main 分支有autoload-dev配置，否则vendor/autoload.php不加载测试类 - 遇到
your requirements could not be resolved，不是依赖冲突严重，往往是某个包的composer.json里写了"php": ">=8.2"，而你本地是 8.1——用composer show vendor/name查它的 require 约束
autoload 自定义失效，new ClassName() 报 Class not found
Composer 只自动加载 psr-4 和 psr-0 配置里的命名空间，手写的工具函数、全局常量、.php 文件里的裸代码，它一概不管。很多人以为改完 composer.json 就行，忘了最关键的一步。
- 新增
"autoload": {"files": ["src/helpers.php"]}后，必须运行composer dump-autoload，否则vendor/autoload.php里还是没这行require -
psr-4映射路径不能带./或../，写成"App\": "app/"对，写成"App\": "./app/"就加载失败——Composer 解析时会把点斜杠当字面量拼进路径 - 如果项目用了
classmap（比如 legacy 代码），记得每次增删文件后手动composer dump-autoload -o，不然 classmap 缓存不会自动更新
Composer 的坑不在命令多难记，而在每一步都隐含环境假设：PHP 版本、扩展开关、网络可达性、锁文件状态、autoload 缓存是否刷新。漏掉其中任何一个，错误信息都不会直说“你少开了 openssl”，只会甩一句 Script @php artisan package:discover handling the post-autoload-dump event returned with error code 255——这种链式报错，得一层层往回扒日志。
