Composer 不提供 format 命令，因其只解析 JSON 语义而不处理格式；格式化需借助 jq、Prettier 等外部工具，并建议团队统一用 jq 预提交钩子规范。
Composer 本身不提供自动格式化功能，composer.json 的“格式化”只能靠外部工具或手动规范；所谓“优雅”，本质是可读、可维护、符合语义，而非花哨排版。
为什么 composer.json 不能用 composer format？
Composer 没有内置格式化命令 —— 它压根不解析 JSON 的空格/换行，只关心键值语义。运行 composer install 或 composer update 时，它会读取并写入 composer.json，但写入行为是“最小化覆盖”：只改你显式操作的字段（比如 require），其余结构、缩进、排序全保留原样。
常见错误现象：composer require foo/bar 后发现文件缩进乱了、字段顺序变了、注释没了 —— 这不是 Composer “格式化”了，而是它用 json_encode(..., JSON_UNESCAPED_SLASHES | JSON_PRETTY_PRINT) 重写了整个 require 块，而原始 JSON 解析后丢失了人工排版信息。
- Composer 不支持注释（JSON 标准不支持），任何
//或/* */都会在写入时被删掉 - 字段顺序无语义，但人类阅读习惯依赖逻辑分组（如先
name/description，再require，最后scripts） -
composer.json是配置文件，不是代码，过度“美化”反而干扰 diff 可读性
真正可用的格式化方案：用 jq 或 IDE 插件
想让 composer.json 整齐、一致、易 review，得绕过 Composer 自身，用通用 JSON 工具处理。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
推荐做法：
- 用
jq格式化并标准化缩进：jq -S '.' composer.json > composer.json.tmp && mv composer.json.tmp composer.json
（-S按键名排序，适合追求确定性输出） - 不想排序？去掉
-S，只美化：jq '.' composer.json > composer.json.tmp && mv composer.json.tmp composer.json
- VS Code 用户装
EditorConfig for VS Code+Prettier，在.prettierrc中加{"parser": "json"}，保存即格式化（注意：Prettier 不支持 JSON 注释） - PHPStorm 可设 JSON 文件默认用 “Reformat Code”（Ctrl+Alt+L），勾选 “Align object properties” 即可对齐冒号
composer.json 编写规范：哪些字段必须对齐？哪些顺序不能乱？
没有官方强制规范，但团队协作中以下约定能显著降低误读概率：
-
name、description、type、license放最前 —— 这是包的“身份证”，一眼看懂用途 -
require和require-dev分开，且内部按字母序排列（方便git diff快速定位增删） -
autoload和autoload-dev紧跟依赖之后 —— 加载规则和依赖强相关 -
scripts放最后 —— 它们是“操作指令”，不是元数据，放底部更符合阅读动线 - 避免嵌套过深：比如
extra下不要塞多层自定义键，用扁平 key 名（extra.symfony-console-version比extra.symfony.console.version更易 grep）
容易被忽略的兼容性陷阱
看似只是空格和换行的事，但某些场景下格式会影响实际行为：
- Git diff 中，如果
require字段因格式化整体重排，会导致“大量修改”假象，掩盖真实变更 —— 建议配合git diff --ignore-space-change或在 CI 中用jq -S统一输入再比对 - 某些老旧 CI 脚本用
grep提取版本号（如grep '"php":' composer.json），若格式化后换行位置变化，可能匹配失败 —— 应改用jq -r '.require.php' -
composer.lock的哈希值对composer.json内容敏感，但仅限键值内容，与空白符无关；不过若格式化工具意外修改了值（如把"^8.1"改成"^8.1.0"），就会触发 lock 文件重生成
最麻烦的不是格式本身，而是团队没共识：有人用 Prettier，有人手敲空格，有人靠 Composer 写入，结果每次 git pull 都带一堆无关空格变更。统一用 jq 脚本做 pre-commit hook，比争论“该用 2 空还是 4 空”实在得多。
