安装并运行 composer-normalize 插件可自动格式化 composer.json 文件。支持全局或项目级安装,执行 composer normalize 即可标准化文件格式,包括字段排序、缩进和换行。提供 --dry-run、--diff 等选项预览修改,可集成到 Git 钩子或 CI 流程中确保团队代码风格一致。

要使用 composer-normalize 插件自动格式化 composer.json 文件,只需安装插件并运行命令即可。这个工具会标准化 JSON 格式、排序字段、清理多余空格和换行,使文件更统一易读。
安装 composer-normalize 插件
在全局或项目中安装该插件:
# 全局安装(推荐,便于多个项目使用)composer global require localheinz/composer-normalize
# 或者只在当前项目中安装
composer require --dev localheinz/composer-normalize
运行 normalize 命令
进入项目根目录(确保有 composer.json),执行:
# 如果是全局安装composer normalize
# 如果是本地安装
./vendor/bin/composer-normalize
执行后,composer.json 会被自动格式化成标准风格,包括字段顺序、缩进、换行等。
常用选项和功能
你可以通过附加参数控制行为:
- --dry-run:预览改动,不会实际修改文件
- --diff:显示具体修改的差异
- --no-update-lock:不自动更新 composer.lock(如有变更)
composer normalize --dry-run --diff
集成到开发流程
可将此命令加入 Git 钩子或 CI 流程,保证团队提交的 composer.json 风格一致。
例如,在 .git/hooks/pre-commit 中添加:
composer normalize --dry-run || { echo "composer.json not normalized"; exit 1; }
这样提交前会检查格式,若未格式化则阻止提交。
基本上就这些。安装后一个命令就能搞定 JSON 格式混乱问题,特别适合团队协作项目。不复杂但容易忽略。










