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 等。这些都应在新环境重建。

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

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

• 确认已安装匹配版本的 PHP 和 Composer（建议使用与原环境一致的 PHP 版本，可通过 php -v 和 composer --version 检查）
• 运行 composer install —— 这会严格按 composer.lock 安装依赖，不更改版本
• 如有需要，再运行 composer dump-autoload（尤其启用 PSR-4 自动加载后）
• 根据项目需求，手动处理环境配置（如复制并编辑 .env，设置数据库连接、密钥等）

如果遇到扩展缺失（如 ext-pdo_mysql），需在新机器安装对应 PHP 扩展，不是靠复制解决。

验证是否迁移成功

快速检查三件事：

• 运行 composer show 查看已安装包列表，对比关键依赖版本是否与 composer.lock 一致
• 执行 php -m | grep your_extension 确认所需 PHP 扩展已启用
• 运行基础命令或测试，例如 php -r "echo 'OK';" 或 ./vendor/bin/phpunit --version（若项目含 PHPUnit）

能正常加载类、执行命令、跑通简单测试，基本就说明迁移完成。

不复杂但容易忽略：锁文件是灵魂，删了它或没传过去，就不是“完整迁移”，而是“重新猜依赖”。