判断 Composer 包是否该升级需先看 require/require-dev 版本约束是否过时，更关键的是是否存在运行时冲突，如下游强制要求 monolog/monolog:^3.0 而你用 ^2.0 会触发依赖解析失败。
如何判断一个 Composer 包是否该升级依赖
直接看 composer.json 里 require 和 require-dev 的版本约束是否过时，但更关键的是：有没有实际运行时问题。比如你用 monolog/monolog:^2.0，但下游项目强制要求 ^3.0，就会触发 root requirements could not be resolved 错误。
实操建议：
- 用
composer outdated --direct查看直接依赖的过期情况，但别盲目升级——尤其注意主版本号变化（如^1.9→^2.0），可能含破坏性变更 - 升级前先跑
composer update --dry-run，确认不会意外拉入不兼容的子依赖 - 对
php自身版本约束（"php": "^8.1"）要和 CI 中实际运行环境严格对齐，否则本地能装、CI 报错
为什么你的包在 Laravel 项目里总被拒绝安装
常见原因是 composer.json 中声明了不合理的 conflict 或过于宽松的 replace，但更隐蔽的问题是：你没声明 provide，或声明了错误的 type。
实操建议：
- 如果包是 Laravel 官方风格的 service provider（如
laravel/framework兼容包），必须设"type": "library"，不能写"type": "laravel-package"（后者仅用于 Packagist 上的元信息，不影响安装逻辑，但会让部分自动化工具误判） - 避免在
conflict中写"laravel/framework": " 这类宽泛限制——Laravel 主版本迭代快，容易让新用户无法安装；改用 <code>"conflict": {"laravel/framework": "11.0.*"}精确屏蔽已知冲突小版本 - 若包提供 Facade 或自动发现功能，务必在
extra.laravel.dont-discover中留空（即不设该键），否则 Laravel 10+ 会跳过自动注册
如何让 composer install 不因 dev-main 被卡住
当你在 composer.json 里写了 "your/package": "dev-main"，而对方包的 composer.json 没设 minimum-stability 或没开 prefer-stable，就可能触发 Could not find package ... matching your minimum-stability。
实操建议：
- 永远不要在生产环境或公开文档中推荐使用
dev-*分支作为依赖版本；发布正式版后立刻用git tag v1.2.0+git push --tags推送语义化标签 - 如果你是包作者，确保
composer.json中有"minimum-stability": "stable"和"prefer-stable": true，这是 Packagist 解析稳定性的依据 - CI 测试时，用
composer install --no-interaction --ignore-platform-reqs可绕过 PHP 版本等平台检查，但上线前必须去掉--ignore-platform-reqs，否则会掩盖真实兼容问题
autoload 配置写错会导致类找不到，但错误提示极不直观
比如你写了 "psr-4": {"MyLib\": "src/"}，但实际类文件路径是 src/MyLib/Helper.php，且命名空间是 MyLibMyLibHelper，Composer 就会静默失败——class MyLibHelper not found，而不是告诉你 autoload 映射错了。
实操建议：
- PSR-4 映射的 namespace 后缀必须和目录结构完全一致：
"MyLib\" → src/意味着MyLibFooBar必须位于src/Foo/Bar.php - 用
composer dump-autoload -o生成优化后的 autoloader，但开发中别长期依赖它——-o会跳过某些动态检查，掩盖路径映射错误 - 测试 autoload 是否生效，最简单方法是删掉
vendor/autoload.php，手动 requirevendor/composer/autoload_psr4.php并 var_dump，看数组里有没有你期望的映射项
真正难的不是写对一行 autoload，而是当多个包互相覆盖同一命名空间、或同时用了 PSR-4 和 classmap 时，谁先加载、谁被忽略——这种顺序问题只能靠 composer show -t 查依赖树，再结合 composer dump-autoload -vvv 看详细加载过程。
