在 composer.json 的根级 "config" 对象中添加 "sort-packages": true 即可启用依赖自动字母排序，该配置仅在 composer update 或 composer update --lock 时生效，不影响 lock 文件和加载逻辑。
composer.json 里怎么启用 sort-packages
默认情况下，Composer 不会自动调整 composer.json 中依赖项的顺序。要让它在每次 composer install 或 composer update 后按字母排序，必须显式开启 sort-packages 配置项。
这个配置是全局或项目级的布尔开关，不是命令行参数，也不能靠插件实现——它只存在于 composer.json 的根级别 "config" 段里。
- 打开你的
composer.json - 确保存在
"config"对象（没有就新建一个） - 在里面添加
"sort-packages": true
示例片段：
{
"require": {
"symfony/console": "^6.4",
"monolog/monolog": "^3.5",
"doctrine/dbal": "^4.0"
},
"config": {
"sort-packages": true
}
}
为什么加了没生效？常见失效原因
即使写了 "sort-packages": true，也常出现“没排序”的错觉，基本都卡在这几个点上：
-
composer install不会重排已安装的包列表 —— 它只读取composer.lock，不修改composer.json；真正触发重排的是composer update（哪怕只更新一个包）或手动运行composer update --lock - 如果
composer.json里"require-dev"和"require"是分开写的，它们各自独立排序，不会跨段混排 - 使用了
composer create-project初始化项目时，原始模板里的composer.json可能被缓存或覆盖，建议初始化后立刻检查并补上config段 - 某些 IDE 或编辑器保存时自动格式化 JSON，可能把字段顺序“还原”回来 —— 排序动作只发生在 Composer 写入时，不是实时监听文件变化
sort-packages 对 lock 文件和协作的影响
sort-packages 只影响 composer.json 的键顺序，对 composer.lock 的结构、内容、哈希值完全无感。但它的副作用很实在：
- 多人协作时，依赖增删容易引发大段
composer.jsondiff，开启后能让每次变更集中在少数几行，Code Review 更轻松 - CI 流程中若用
composer install --dry-run或校验文件一致性，只要没改依赖版本，composer.json就不该变 —— 但若有人本地没开sort-packages，提交了未排序的文件，就会意外触发 diff - 它不改变解析逻辑，也不影响加载顺序或自动加载行为，纯属可读性优化
想临时关闭排序？别删配置，用命令行覆盖
偶尔需要绕过排序（比如合并分支时想保留某次手动整理的顺序），不需要注释或删除 "sort-packages": true。直接在命令末尾加：
composer update --no-sort
或者：
composer install --no-sort
这个参数优先级高于 composer.json 里的设置，且只对当次命令生效。适合脚本化部署或调试依赖写入逻辑时快速验证。
注意：如果你的项目长期多人维护，最好把 "sort-packages": true 加进 .gitattributes 或团队规范里 —— 因为一旦有人漏配，下次他 update 就会悄悄打乱顺序，而这种改动极难被 git blame 追踪到。
