composer.json和composer.lock必须成对备份,单独备份composer.json无效,因lock文件才精确锁定依赖版本;缺失lock会导致install拉取不兼容版本,引发环境不一致、CI失败等问题。

composer.json 和 composer.lock 必须一起备份,不能只存一个
单独备份 composer.json 没用——它只声明“想要什么”,真正锁定依赖版本的是 composer.lock。如果只备份前者,恢复时 composer install 会按当前最新兼容版本拉取,很可能引入不兼容变更或安全漏洞。
常见错误现象:composer install 在另一台机器上装出完全不同的 vendor/ 内容,CI 构建失败,本地开发环境和生产行为不一致。
- 每次备份都应成对保存:
composer.json和composer.lock - 文件名建议加时间戳和 Git 提交哈希,例如:
composer-json-20261103-abc123.json、composer-lock-20261103-abc123.lock - 不要用模糊命名如
composer-backup.json——无法判断对应哪次发布或哪个分支
全局配置 config.json 备份要带用户标识,避免混用
~/.composer/config.json 存的是你个人的认证令牌、仓库镜像、默认包类型等设置。多人共用服务器或切换系统用户时,直接复制这个文件会导致凭证错乱、私有包拉取失败。
使用场景:你在 CI 机器上用 deploy 用户跑 Composer,但本地开发用的是自己的账号;或者团队成员共享测试服务器。
使用 template.yaml 定义创建 Spotify Backstage 软件模板,包含 Scaffolder 操作,包括 fetch:template、publish:github 和 catalog:register。通过其 REST API 管理 Backstage 软件目录。
- 备份时重命名为
composer-config-deploy-20261103.json这类带角色/用户名前缀的名称 - 不要只叫
config.json或global-config.json,容易覆盖或误还原 - 敏感字段如
github-oauth或http-basic建议在备份后手动脱敏(或改用composer config --global --auth管理)
vendor 目录要不要备份?看场景再决定
备份整个 vendor/ 是最慢、最占空间的操作,但某些场景下不可替代:离线环境部署、CI 缓存失效、或依赖私有 Git 仓库且无 Packagist 镜像。
性能与兼容性影响:一个中型项目 vendor/ 可达 200MB+,压缩后仍需分钟级传输;且不同 PHP 版本或扩展启用状态可能导致部分包二进制不兼容。
- 推荐策略:日常备份跳过
vendor/,仅靠composer install恢复;仅在明确需要离线部署时才打包 - 若真要备份,压缩命令必须排除 dev-only 文件:
tar --exclude='*/tests' --exclude='*/docs' -czf vendor-20261103.tar.gz vendor/ - 切勿把
vendor/提交进 Git —— 即使加了时间戳命名,也违背 Composer 设计原则
备份文件路径里别用空格和中文,Linux 下容易出错
很多脚本和 CI 工具(比如 Jenkins 的 shell 步骤、Ansible 的 copy 模块)对含空格路径处理不稳定,cp /path/to/my backup/composer.json . 会被拆成两个参数,直接报错。
容易踩的坑:在桌面环境用图形化文件管理器创建带空格的备份目录,然后在终端里用自动补全复制路径,看似正常,实际执行失败。
- 路径命名统一用小写字母 + 短横线:
/backups/composer-project-api-20261103/ - 避免
My Backup、项目备份、composer_v2.0_备份这类写法 - 检查路径是否合法:运行
ls -l "/your/backup/path",确认输出中没有反斜杠转义或乱码
composer-bak.zip 到底对应哪次上线。

















