vendor/composer/installed.json文件有什么作用_深入解析Composer内部依赖状态记录

installed.json是Composer生成的本地安装快照，记录vendor目录中所有已安装包的名称、版本、自动加载配置等信息，用于提升后续命令执行效率；它与composer.lock的区别在于前者是运行时索引，后者是依赖一致性锁定文件；每次执行install、update等操作时自动更新，可删除但会降低性能，通常应忽略于版本控制。

vendor/composer/installed.json 文件是 Composer 在执行依赖安装或更新时自动生成的一个关键元数据文件，它记录了当前项目中所有已安装的 Composer 包的详细信息。这个文件并不直接供开发者手动编辑，而是由 Composer 内部维护，用于高效管理项目的依赖状态。

该文件的核心作用

installed.json 的主要功能是保存当前 vendor 目录下所有已安装包的结构化清单，包括每个包的名称、版本、自动加载配置、安装路径、依赖关系等。它相当于 Composer 的“本地安装快照”，使得后续命令（如 update、install、dump-autoload）无需每次都重新解析整个 composer.lock 或远程仓库，从而提升执行效率。

• name：包的完整名称（如 monolog/monolog）
• version：安装的具体版本号（如 v2.8.0）
• dist：包的分发信息（URL、sha1 等）
• source：源码引用（适用于开发版依赖）
• autoload：自动加载配置（PSR-4、classmap 等）
• type：包类型（library、project、metapackage 等）
• installation-source：安装来源（dist 或 source）

与 composer.lock 的区别

composer.lock 记录的是整个项目依赖的精确树形结构，用于保证团队间依赖一致性；而 installed.json 更像是 vendor 目录的运行时索引。Composer 在启动时会优先读取 installed.json 来判断哪些包已经存在，避免重复下载和解压，显著加快 install 流程。

当你运行 composer install 且 vendor 已存在，Composer 会对比 lock 文件与 installed.json 的内容，仅对发生变化的部分进行操作，这种增量更新机制正是依赖此文件实现的。

何时会更新该文件

每次执行 composer install、update、require 或 remove 命令后，只要 vendor 中的包有增删改，installed.json 都会被自动重写以反映最新状态。如果你删除 vendor 目录后重新安装，该文件也会被重建。

Docky AI

多合一AI浏览器助手，解答问题、绘制图片、阅读文档、强化搜索结果、辅助创作

87

查看详情

在 CI/CD 环境中，虽然通常从 composer.lock 安装，但一旦安装完成，installed.json 就成为后续脚本（如生成 autoload 文件）的重要依据。

能否删除或忽略

可以将 installed.json 添加到 .gitignore 中，因为它属于生成文件，不应提交到版本控制。删除它不会破坏项目功能，但下次运行 Composer 命令时会触发一次完整的扫描重建过程，略微影响性能。

某些高级用法（如插件开发）可能需要读取该文件来获取已安装包列表，因此不建议在生产构建流程中依赖其存在，而应使用 Composer API 进行安全访问。

基本上就这些。理解 installed.json 有助于更深入掌握 Composer 的工作原理，尤其是在调试自动加载异常或构建自定义工具链时非常有用。

以上就是vendor/composer/installed.json文件有什么作用_深入解析Composer内部依赖状态记录的详细内容，更多请关注php中文网其它相关文章！