Composer 本身不提供内置命令排序，需在composer.json的config中设置"sort-packages": true，仅在composer require或update修改JSON时，按ASCII升序自动重排require和require-dev字段的包名。
composer.json 的包列表怎么按字母顺序自动排序？
Composer 本身不提供内置命令对 require 或 require-dev 中的包名做字母排序，手动排容易漏、易出错，尤其在多人协作时格式不一致还会触发无意义的 Git diff。
推荐用 composer-normalize 工具——它不只是排序，还能统一键顺序、缩进、末尾逗号，并验证 JSON 结构合法性：
- 安装：
composer global require sullivanj0/composer-normalize - 运行：
composer normalize（当前目录）或composer normalize composer.json - 它默认按字母升序排列所有依赖项（包括
require、require-dev、autoload下的psr-4映射等） - 支持
--dry-run预览变更，--diff输出 patch 格式差异
注意：该工具会重写整个 composer.json，建议提交前确认 diff；若项目用了自定义字段（如 scripts 中非常规键），它默认保留但不参与排序逻辑。
为什么 composer install 后 vendor 里包的目录顺序不是字母序？
vendor 目录下包的文件夹名顺序和 composer.json 里的声明顺序无关，也**不按字母排序**。Composer 安装时依据的是依赖解析结果（拓扑排序），优先满足依赖关系，而非字典序。
常见误解是“排序 composer.json 就能让 vendor/ 整齐”，实际不会。如果你为调试或排查方便想快速定位某个包，直接用 shell 命令更可靠：
- Linux/macOS：
ls vendor/ | sort或find vendor -maxdepth 1 -type d | sort - Windows PowerShell：
Get-ChildItem vendor -Directory | Sort-Object Name
不要试图靠调整 composer.json 顺序来控制 vendor/ 排列——这既无效，还可能干扰依赖解析的可预测性。
换国内镜像源后 composer update 还很慢？检查这三处
阿里云、腾讯云、华为云等镜像源本身响应快，但慢往往卡在其他环节：
- 确认镜像已全局启用：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/（注意末尾无斜杠） - 检查是否被
composer.json里的repositories覆盖：如果项目中定义了"repositories": [{"type": "composer", "url": "https://packagist.org"}]，会无视全局配置，删掉或改成镜像地址 - 清除旧缓存：
composer clear-cache；某些旧版本 Composer（composer self-update 最新版能明显改善
镜像源只加速元数据下载（packages.json 等），但真正耗时的是 ZIP 包下载——这部分也走镜像，前提是镜像站同步完整。阿里云镜像偶尔滞后几小时，可临时切 https://packagist.phpcomposer.com（已停用）或改用清华源 https://packagist.org 的代理地址（如 https://mirrors.tuna.tsinghua.edu.cn/composer/）。
JSON 格式化时要不要加尾逗号、用 tab 还是空格？
composer.json 是标准 JSON，**不支持尾逗号（trailing comma）**，加了会导致 composer validate 失败或解析报错 JSON decode error: Syntax error。
缩进风格没有强制要求，但必须一致：
- Composer 官方示例和
composer init默认用 4 个空格 - VS Code / PHPStorm 用 Prettier 或 built-in JSON formatter 时，关掉 “trailingComma” 选项，缩进设为 4 spaces
- 别用 tab —— 某些 CI 环境或旧版 Composer 会把 tab 解析为非法字符，报
Unexpected token \t
最省心的做法：交给 composer normalize 处理，它默认用 4 空格、无尾逗号、键名引号统一、对象属性按规范顺序排列——比手调安全得多。
