Composer的vendor/composer/installed.json文件有什么作用？（深入剖析）

installed.json 是 Composer 维护的 vendor 目录状态镜像文件，记录已安装包的名称、版本、路径、autoload 配置、依赖关系及开发/启用状态，用于自动加载器生成、依赖查询与插件扩展，不参与代码执行，不应提交至 Git。

installed.json 是 Composer 在项目中自动生成并维护的核心元数据文件，位于 vendor/composer/installed.json。它不参与代码执行，也不被 PHP 直接加载，但它是 Composer 运行时依赖解析、自动加载、插件激活、版本校验等关键行为的**事实数据源**。

记录已安装包的完整快照

每次成功执行 composer install 或 composer update 后，Composer 会将当前 vendor/ 目录下所有已安装包（包括 root 包）的精确信息写入该文件。内容包含：

• 每个包的名称、版本号（含完整 commit hash 或 exact version）、安装路径（如 vendor/symfony/console）
• 该包的 autoload 配置（psr-4、psr-0、classmap、files 等），用于生成 vendor/autoload.php
• 依赖关系快照（require 列表），但仅作记录，不用于实时解析
• 是否为开发依赖（dev 字段标记）、是否启用（enabled 字段，供插件控制）

这个文件本质上是 vendor/ 的“状态镜像”——它告诉你此刻磁盘上真实存在哪些包、以什么形态存在，而非 composer.lock 所声明的“应该存在什么”。

支撑自动加载器的动态构建

Composer 的自动加载逻辑（即 vendor/autoload.php 及其生成的 vendor/composer/autoload_*.php 文件）并非静态写死，而是在每次 dump-autoload 或安装时，**读取 installed.json 中所有包的 autoload 配置，合并后生成最终映射表**。这意味着：

Videoleap

Videoleap是一个一体化的视频编辑平台

139

查看详情

• 如果你手动修改了某个包的 composer.json 中的 autoload 规则但未重新 dump，变更不会生效
• 插件（如 composer-plugin-api 实现者）可通过监听事件，在安装后动态向 installed.json 注入或修改 autoload 条目
• 当使用 --no-autoloader 安装时，installed.json 仍会被写入，但 autoload 字段可能为空或被跳过

服务运行时依赖查询与插件扩展

Composer 自身命令（如 composer show、composer outdated）以及第三方插件，普遍通过读取 installed.json 获取本地已安装包的真实状态：

• composer show --installed 不解析 composer.lock，而是直接解析此文件输出表格
• 插件可利用其中的 version 和 dist.reference 字段做灰度加载、运行时补丁注入
• 某些部署工具（如 Capistrano + Composer 插件）用它校验 vendor 是否完整，避免仅靠 vendor/ 目录是否存在来判断安装成功

注意：它不包含远程仓库信息或哈希校验值（那是 composer.lock 的职责），也不保证结构稳定——Composer 主版本升级可能调整字段名或嵌套层级。

与 composer.lock 的关键区别

很多人混淆 installed.json 和 composer.lock，二者定位截然不同：

• composer.lock 是声明式锁文件：描述“本次安装应达成的状态”，用于跨环境复现，提交进 Git
• installed.json 是反映式状态文件：描述“当前 vendor 目录实际达成的状态”，是运行时产物，不应提交，且每次安装后都会重写
• lock 文件缺失会导致 install 退化为 update；而 installed.json 缺失只会让 Composer 在下次安装时重建它（不影响功能）
• 你可安全删除 installed.json，再运行 composer install，它会立刻恢复；但删掉 composer.lock 再 install，结果很可能不同

以上就是Composer的vendor/composer/installed.json文件有什么作用？（深入剖析）的详细内容，更多请关注php中文网其它相关文章！