Composer插件元数据备份只需复制composer.json和composer.lock文件,二者共同记录依赖名称、版本、来源、自动加载规则及插件启用状态等全部权威信息,vendor目录仅为可重建产物,不可替代源事实。

Composer 本身不提供“插件元数据”的独立备份机制,所谓“批量备份插件元数据”实际是指备份 composer.json 和 composer.lock ——它们才是真实记录所有依赖(含插件)名称、版本、来源、自动加载规则等元数据的唯一权威来源。
为什么不能只备份 vendor 目录里的插件文件
vendor 目录只存代码和自动加载映射,不含版本约束、require-dev 标记、scripts 定义、repositories 配置等关键元数据。一旦 composer.json 损坏或丢失,你无法可靠还原插件的原始安装意图,甚至无法判断某个包是 require 还是 require-dev 引入的。
-
vendor/是可重建的产物,不是源事实 - 插件的启用状态(如通过
extra.plugin或type:composer-plugin声明)只存在于composer.json中 -
composer.lock记录了精确的 commit hash / dist URL / install path,这是可重现构建的唯一依据
真正有效的批量元数据备份方式
直接复制项目根目录下的两个文件即可完成“全部插件元数据”的备份,无需额外解析或遍历:
专业音乐创作规划。基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲,自动规划曲风、节奏、乐器编配和人声特色,将模糊需求转化为精准 Prompt。支持纯器乐和中文歌词歌曲。
- 运行
cp composer.json composer.lock /backup/path/(Linux/macOS) - Windows 用户可用
copy composer.json composer.lock C:\backup\ - 若需批量处理多个项目,用 shell 脚本遍历目录并检查是否存在
composer.json:for d in */; do [ -f "$d/composer.json" ] && cp "$d/composer.json" "$d/composer.lock" "/backup/$d"; done
- 注意:不要依赖
composer show --format=json输出做备份——它不包含 lock 文件中的哈希与完整依赖图,且不含extra字段等定制元数据
误以为需要“扫描插件”才叫备份的常见陷阱
有人试图用 composer global show 或 composer info vendor/package 提取插件列表再存为 CSV,这完全偏离目标:
- 全局插件(
composer global require)的元数据不在项目内,应单独备份~/.composer/composer.json和~/.composer/composer.lock -
composer show输出的是当前已安装状态,不是声明式配置;如果 vendor 被删而没 lock 文件,show 就失效了 - 插件可能通过
repositories自定义源引入,这些 URL 只在composer.json里定义,show 不会反向推导
最易被忽略的一点:composer.lock 必须和 composer.json 成对备份。丢掉 lock 文件,就等于丢掉了确定性——哪怕所有插件名都在 json 里,你也无法保证下次 install 装出完全一致的版本组合。










