在 composer.json 根对象中添加 "sort-packages": true 即可启用自动排序，下次运行 composer require、update 或 install 时会按字母升序重排 require 和 require-dev 中的包名，仅影响键名顺序，不改变版本约束或格式缩进。

composer.json 里怎么开启 sort-packages

直接在 composer.json 的根对象里加一行配置就行，不需要插件或额外命令：

• "sort-packages": true 必须是顶层字段，不能塞进 config 或 extra 里
• 加完后下次运行 composer require、composer update 或 composer install，都会自动重排 require 和 require-dev 里的包名（按字母升序）
• 注意：它只影响包名顺序，不改变版本约束写法，也不动 autoload 或其他字段

为什么加了没生效？常见卡点

最常踩的坑不是配置错，而是「没触发重排时机」：

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

• 只改了 composer.json 但没运行任何 composer 命令 —— sort-packages 是运行时行为，不是静态格式化工具
• 用了 composer install 但 vendor/ 已存在且 composer.lock 没变 —— 此时 Composer 默认跳过依赖解析，也就不会重排 composer.json
• 手动编辑过 composer.json 的依赖块（比如删空行、调换顺序），而 Composer 重排时会抹掉你的手工格式 —— 它只保证键名顺序，不保留换行和缩进

sort-packages 对 lock 文件和协作的影响

这个配置本身不改变依赖解析逻辑，但会影响团队协作的 diff 干净度：

• composer.lock 不受 sort-packages 影响 —— 它的结构固定，排序由内部算法决定，和 JSON 配置无关
• 多人同时增删包时，如果一方开了 sort-packages，另一方没开，composer.json 的 diff 会巨多（整块重排），容易引发无意义冲突
• 建议全团队统一开关：要么都设 true，要么都删掉该字段（默认为 false）

想临时禁用排序，但又不想删配置

没有官方“临时关”开关，但有更稳妥的做法：

• 运行命令时加 --no-sort-packages 参数，例如：composer require foo/bar --no-sort-packages
• 该参数优先级高于 composer.json 里的设置，且只作用于当次命令
• 注意：不是所有命令都支持它 —— composer install 和 composer update 支持，但 composer dump-autoload 这类不碰依赖列表的命令不认这个参数

实际效果取决于你是否让 Composer 重新读取并写回 composer.json。很多人配完就以为完事了，其实差了一次真正触发依赖操作的命令。