如何将一个 Composer 项目及其依赖完整地迁移到另一台机器？

Composer 项目迁移需保留 composer.json、composer.lock 和源码等必要文件，删除 vendor 等生成物，在新环境运行 composer install 确保依赖一致；锁文件缺失将导致依赖版本不可控。

直接复制整个项目文件夹通常不行，关键在于只保留 源码和声明性配置，让 Composer 在新机器上重新解析、下载并安装依赖。

确保迁移前项目结构干净规范

Composer 项目必须包含以下两个核心文件，缺一不可：

• composer.json：定义项目名称、版本、依赖（require）、开发依赖（require-dev）、自动加载规则等。这是所有操作的唯一依据。
• composer.lock：记录每个依赖包的确切版本、哈希值和嵌套依赖关系。它保证在不同机器上安装出完全一致的依赖树。

如果项目里没有 composer.lock，请先在原机器运行 composer install 或 composer update 生成它（推荐 install 以保持现有版本稳定）。

只复制必要文件，排除生成物和缓存

迁移时只需拷贝以下内容到新机器：

• composer.json
• composer.lock
• 你的源代码（如 src/、tests/、public/ 等目录）
• 其他非生成类配置文件（如 .env、phpunit.xml 等）

务必不要复制：vendor/ 目录、composer.phar、各类日志、缓存、IDE 配置（如 .idea/）、node_modules 等。这些都应在新环境重建。

在新机器上执行标准安装流程

进入项目根目录后，按顺序执行：

标签： mysql php js json node composer idea 配置文件 环境配置