Composer不支持一键克隆，所谓“快速重建环境”需同时满足三要素：统一PHP版本、固定阿里云镜像源（composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/）、项目级composer.json中预置repositories字段；缺一则composer install可能卡住或装错包。
不用“一键克隆”这种虚词——Composer 本身不支持环境镜像打包复刻，所谓“一键克隆”实际是「快速重建可复用的开发环境」，核心靠三件事：统一 PHP 版本、固定 Composer 镜像源、预置项目级配置。漏掉任意一个，新机器上 composer install 就可能卡住或装错包。
为什么 composer config -g repo.packagist 经常失效
全局镜像配置只对全新初始化的项目生效；已有项目只要 composer.json 里写了 "repositories" 字段，就会直接覆盖全局设置。更隐蔽的问题是权限：Windows 下 PHPStudy 默认以管理员权限运行 GUI，但终端（CMD/PowerShell）常以普通用户身份启动，composer config -g 写入的其实是 C:\Users\{user}\AppData\Roaming\Composer\config.json，而 PHPStudy 内部调用的 Composer 可能读的是它自己控制的路径（如 C:\phpstudy_pro\Extensions\composer）。
- 先执行
composer config -g --list，确认输出中home路径可写（右键属性 → 安全 → 当前用户有“修改”权限） - 打开项目根目录下的
composer.json，删掉或注释掉整个"repositories"块 - 如果用 PHPStudy，直接在「工具 → Composer管理」里点「切换镜像」，它会同时改 GUI 和 CLI 两处配置
Windows 下手动安装 composer.phar 的关键路径细节
很多人把 composer.phar 放进 C:\php\，却忘了 composer.bat 必须和 php.exe 在同一目录才能正确解析 %~dp0。如果 PHP 是通过 PHPStudy 安装的，真实路径通常是 C:\phpstudy_pro\Extensions\php\php8.2nts\（注意版本后缀），而不是你直觉认为的 C:\php。
- 用
where php或php -v确认 CLI PHP 实际路径 - 把
composer.phar复制到该目录下（和php.exe并列） - 在**同一目录**下新建
composer.bat，内容严格为：@php "%~dp0composer.phar" %*（无空格、无 BOM、换行符为 LF） - 重启终端，再运行
composer --version
项目级 composer.json 必须内置镜像声明
靠全局配置无法保证协作一致性——队友没配镜像、CI 构建机没登录、Docker 构建阶段用的是干净镜像，都会导致 composer install 直接连不上 packagist.org。最稳妥的做法是在项目 composer.json 顶层加 "repositories"，且 URL 必须用阿里云最新地址（旧的 packagist.phpcomposer.com 已停服）。
立即学习“PHP免费学习笔记（深入）”；
{
"repositories": [
{
"type": "composer",
"url": "https://mirrors.aliyun.com/composer/"
}
],
"require": {
"monolog/monolog": "^2.10"
}
}
- 不要用
composer config repo.packagist生成这个块——它会写成扁平结构，容易被后续命令误删 - 如果项目用 Laravel，检查
composer.lock是否已提交；未提交时，不同人install可能拉取不同版本 - CI 脚本里加一句
composer config --no-plugins --global repo.packagist composer https://mirrors.aliyun.com/composer/作为兜底
真正能“克隆”的不是 Composer 本身，而是你把 PHP 版本、php.ini 关键扩展（curl、openssl、mbstring）、镜像源、以及 composer.json 里的约束规则全部显式固化下来。少一个，就不是克隆，是碰运气。
