关掉 sort-packages 只需在 composer.json 根级设 "sort-packages": false；5.0+ 默认 true，设 false 后 require 和 require-dev 顺序将保持手动编写状态，不再自动重排。
默认开启 sort-packages 会打乱你手动写的依赖顺序，想关掉它，直接改 composer.json 就行，不需要额外命令或插件。
怎么关掉 sort-packages 自动排序
Composer 5.0+ 默认启用 "sort-packages": true，每次 composer require 或 composer update 都会重排 require 和 require-dev 里的包。关掉只需在根级配置里显式设为 false：
{
"sort-packages": false,
"require": {
"monolog/monolog": "^2.8",
"symfony/console": "^6.3"
}
}
改完保存，后续所有操作都不会再自动重排顺序。
为什么关掉它？哪些场景真需要手动顺序
多数时候排序无所谓，但以下情况顺序会影响可读性或协作体验：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 团队约定按「核心框架 → 常用工具 → 业务专用」分组写依赖，靠顺序传达结构意图
- CI/CD 脚本或文档里直接引用
composer.json中某一行（比如“第 5 行是 DB 驱动”），重排后定位失效 - 用 diff 工具审查依赖变更时，自动重排会产生大量噪音，掩盖真实增删
容易踩的坑：false 不生效？检查这几点
设了 "sort-packages": false 却发现还是被重排，常见原因有：
-
composer.json格式错误（比如多逗号、缺引号），导致 Composer 忽略该字段——用composer validate检查 - 项目用了
composer-merge-plugin或自定义脚本，在合并后又触发了重排 - 本地 Composer 版本太老（composer self-update
- 执行的是
composer update --with-dependencies等带强制解析的命令，个别版本会绕过配置
顺带提一句：sort-packages 不影响安装行为
这个开关只控制 composer.json 文件里依赖项的书写顺序，和包安装顺序、加载顺序、类自动加载完全无关。PHP 自动加载靠的是 autoload 配置和 PSR 规则，不是 require 里的排列顺序。
所以别担心关掉它会影响运行——它只管“人怎么看”，不管“程序怎么跑”。真正容易被忽略的是：很多人以为关掉后 composer require 会把新包插在光标位置，其实不会，它永远追加到对应区块末尾；如需插入中间，只能手动编辑。
