实战教程Composer 2，全网最详细

实战教程Composer 2，全网最详细。我最近刚用Composer 2把项目升级了，结果直接踩了大坑。现在回过头来看，不是版本升级的问题，而是配置文件没改对。你要是用Composer 2，必须把`composer.json`里的`"minimum-stability"`改成`"stable"`，否则会下载到开发版包，导致依赖冲突。别傻乎乎地以为升级就完了，配置得跟上。我之前就是没改这个，项目运行半小时后就开始报错，原来是因为某个包在开发版里有新特性，但稳定版里没有，直接崩溃。这玩意儿真不是开玩笑的，得仔细核对。

我上周参加了一个技术分享会，有人用Composer 2做项目初始化，结果在`composer install`的时候卡住了。他用的是`--no-plugins`参数，结果发现依赖解析器卡在某个包上。我问他是不是没装好Composer，他说装好了。其实问题出在`composer.json`里写了`"prefer-stable": true`，但没写`"minimum-stability": "stable"`。这俩参数得一块用，不然 Composer 2会优先用开发版，即使你写了prefer-stable。你要是用这个版本，记得两个参数都加上，别想当然。

用Composer 2管理依赖时，有个细节特别容易被忽略。就是当你运行`composer update`，它会自动更新所有依赖到最新版本，但有时候你只想要更新某个包。这时候得用`composer update vendor/package`，别直接写`composer update`。我之前就因为这个，把项目里的几个关键包更新到不兼容的版本，导致整个项目崩溃。后来翻文档才发现，要指定包名才能精准控制版本变化。这个小技巧能帮你省不少事。

有次我在一个老项目上改用Composer 2，结果发现`composer.lock`文件格式变了。原来在Composer 2里，lock文件的结构和之前不同，不能直接用旧版本的lock文件。我一开始没直接复制粘贴旧lock文件，结果 Composer 2 报错说无法解析。这时候得手动运行`composer install`，它会根据`composer.json`重新生成lock文件。要是你非要用旧lock文件，那得用`composer install --lock`参数，或者直接删掉lock文件再运行。这算个坑，但能避免。

我在一个团队里看到有人用Composer 2初始化项目的时候，把`composer.json`里的`"require"`写成了`"requires"`。这明显是拼写错误，结果导致依赖安装不成功。他们折腾了好久才发现，最后同事说“你是不是在复制粘贴的时候打错了？”我一听就明白了。 Composer 2对拼写错误真的不宽容，它会直接报错，不会像旧版那样默默忽略。所以你写`composer.json`的时候，拼写得认真点，别图省事。这个错误看起来小，但真能把你卡住。

有些项目里用的是私有包，升级到Composer 2后，发现`composer require`命令失效了。原来 Composer 2默认不支持私有包安装，除非你配置了`auth.json`。我之前遇到这个问题，以为是权限问题，结果发现是没配置认证。这时候得在项目根目录下创建一个`.composer/auth.json`文件，然后填上你的token。配置好之后，再运行`composer require`就能拉取私有包了。如果不配置， Composer 2会直接报错，而且不给你绕弯子。

有个同事用Composer 2做项目依赖管理，结果发现`composer install`特别慢。后来排查发现，他用了`--prefer-dist`参数，但没开`--optimize-autoloader`。这就像在跑马拉松的时候没穿跑鞋，效率差太多了。建议你不管用哪个版本，安装完依赖后都加上`--optimize-autoloader`，这样能大大减少后续的加载时间。我之前没这么做过，结果每次启动项目都要等十几秒，现在加上这个参数，启动时间直接砍了一半。这招我推荐你试试。

有一次我用Composer 2执行`composer dump-autoload`，结果发现生成的文件里有重复的类路径。这让我有点懵，以为是版本问题。后来才意识到是`composer.json`里有多个`autoload`配置冲突了。比如同时写了`"psr-4"`和`"classmap"`，或者`"files"`和`"psr-4"`。我之前就遇到这种情况，最后删掉其中一个配置才解决问题。 Composer 2对配置的严谨性要求更高了，你得检查一下有没有重复的autoload块。这可能是你项目启动慢的元凶。

用Composer 2时，要特别注意`composer.json`里的`"config"`块。我之前遇到一个项目，他们用了`"config": {"preferred-install": "dist"}`，但后来发现依赖安装总是失败。后来查了下，因为某些私有包或特定类型的包在Composer 2里不支持dist安装，必须用源码。这时候就得改成`"preferred-install": "source"`，或者在`composer.json`里加`"platform": {"php": "8.1.12"}`来指定环境。这有点细，但真实情况是，有些包在Composer 2里安装方式变了，你得根据情况调整。别硬刚，要灵活。