Composer 不支持直接在 composer.json 中引用外部 JSON 文件，但可通过四种方式实现配置拆分：1. 使用 config.extra + 自定义脚本加载外部配置；2. 利用环境变量与 config.platform 动态覆盖；3. 借助 composer-merge-plugin 等插件合并多文件；4. 用模板+脚本生成最终 composer.json。
Composer 本身不支持直接在 composer.json 中通过类似 include 或 require 的方式引用另一个 JSON 文件。但可以通过几种实用方式实现配置拆分，兼顾可维护性与兼容性。
用 Composer 的 config.extra + 自定义脚本加载外部配置
把非核心配置（如构建参数、环境变量、自定义字段）移到单独的 JSON 文件（如 composer-extra.json），再在 composer.json 的 extra 字段中声明路径，配合 scripts 在安装/更新时读取处理：
- 创建
composer-extra.json，存放你希望分离的键值对，例如：{ "build": { "assets_dir": "public/assets", "version_file": "VERSION" } } - 在
composer.json中添加："extra": { "extra-config-file": "composer-extra.json" }, "scripts": { "post-install-cmd": [ "@php -r \"file_exists($argv[1]) && print_r(json_decode(file_get_contents($argv[1]), true));\" -- composer-extra.json" ] } - 更进一步，可写一个 PHP 脚本（如
bin/load-extra.php）解析并注入到环境或生成配置文件，供项目其他部分使用。
用环境变量 + config.platform 动态覆盖
适合按环境区分 PHP 版本、扩展等平台约束。虽然不是“引用文件”，但能实现配置外置化：
- 把平台配置写进
.env或 CI 环境变量，例如：COMPOSER_PLATFORM_PHP=8.2.10 COMPOSER_PLATFORM_EXT_INTL=true
- 在
composer.json中使用占位符（需配合插件或 wrapper 脚本解析）；或直接在 CI 中运行：composer install --platform=php:${COMPOSER_PLATFORM_PHP} --platform=ext-intl:${COMPOSER_PLATFORM_EXT_INTL} - 注意：
config.platform本身是静态字段，不能自动读环境变量，必须靠外部命令传参或用工具（如roave/composer-dependency-check的配套机制）辅助。
用 Composer 插件实现配置合并（进阶方案）
如果你需要真正“合并”多个 JSON 文件（比如 composer.base.json + composer.dev.json），可借助第三方插件：
-
hirak/prestissimo不适用，它专注加速；但composer-merge-plugin是经典选择（注意：仅支持 Composer 1.x，Composer 2+ 需用其分支wikimedia/composer-merge-plugin）。 - 启用后，在
composer.json中写："extra": { "merge-plugin": { "include": [ "composer.local.json", "packages/*.json" ], "recurse": true, "replace": false, "merge-dev": true } } - 它会自动合并
require、repositories、autoload等字段——适合大型团队按模块拆分依赖配置。
推荐做法：用 Makefile / Shell / PHP wrapper 管理多环境 composer.json
最可控、无依赖、兼容所有 Composer 版本的方式：
- 保留一个模板
composer.json.tpl，用{{PHP_VERSION}}等占位符； - 写个简单 PHP 脚本或
make generate-composer，根据当前环境填充变量，生成最终composer.json； - 把生成后的文件加入
.gitignore，只提交模板和生成逻辑；CI 中先运行生成再执行composer install。 - 优点：零额外依赖、逻辑清晰、便于测试不同配置组合。
基本上就这些。没有原生 include，但通过 extra + scripts、插件或外部构建流程，完全可以优雅拆分复杂配置。选哪种取决于你的团队规模、CI 能力和是否愿意引入插件依赖。
