换国内镜像源并禁用废弃插件即可解决yii2安装卡顿问题：先执行composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/切换阿里云镜像，再卸载fxp/composer-asset-plugin并配置asset-packagist.cn替代bower源。

Yii2 本身没有“跳转国内”这个说法，你实际想解决的是：**用 Composer 安装 Yii2 时卡在 packagist.org、下载极慢甚至失败**——根本原因是默认源在国外，DNS 解析慢、连接不稳定，尤其在国内网络环境下。 核心就两件事：换镜像源 + 关掉旧插件。下面给你可直接执行的完整方案。

一、全局配置 Composer 国内镜像（必做）

执行任意一条命令即可（推荐阿里云，稳定且同步及时）：

• 阿里云镜像（首选）： composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
• 腾讯云镜像：composer config -g repo.packagist composer https://mirrors.cloud.tencent.com/composer/
• Laravel China 镜像（历史较久，偶有延迟）：composer config -g repo.packagist composer https://packagist.laravel-china.org

执行后可用 composer config -g -l | grep packagist 验证是否生效，输出应为你的镜像地址。

二、禁用 fxp/composer-asset-plugin（关键！）

这个插件早已废弃，是 Yii2 安装卡死的元凶之一——它强行拉取 Bower/NPM 包，而国内访问 Bower 官方源基本不可用。

正确做法是：彻底卸载它，并改用 asset-packagist.cn：

• 卸载旧插件：composer global remove fxp/composer-asset-plugin
• 启用新方案（自动处理前端资源）：composer config -g fxp-asset.installer-paths {"npm-asset-library": "vendor/npm", "bower-asset-library": "vendor/bower"}
• 添加 asset-packagist 源：composer config -g repositories.asset-packagist '{"type": "composer", "url": "https://asset-packagist.cn"}'

三、安装 Yii2 项目（带容错参数）

完成前两步后，再运行安装命令。建议加上两个实用参数：

极简智能王

一款集合AI聊天、绘画、写作、翻译和编程等能力的综合型AI助手，帮助用户处理多种日常学习与工作任务。

下载

• --ignore-platform-reqs：绕过 PHP 扩展版本限制（比如你用 PHP 8.3 装老版 Yii2）
• --prefer-dist：优先下载压缩包而非 Git 克隆，更快更稳

示例（安装基础模板）：

composer create-project --prefer-dist --ignore-platform-reqs yiisoft/yii2-app-basic basic

高级模板同理：

composer create-project --prefer-dist --ignore-platform-reqs yiisoft/yii2-app-advanced advanced

安装完成后，别忘了进项目目录执行：php init（初始化环境）。

四、官网入口与备用资源

Yii 官网中文站（文档 & 下载）：https://www.php.cn/link/3d843a7eae2eed4d9992eb7914599c14
Composer 官方中文镜像说明页（含阿里云等配置指引）：https://www.php.cn/link/2a3a716a08e17e30c49da904bf94a40e
Asset-Packageist 中文镜像（替代 Bower）：https://www.php.cn/link/d7e2dee2a1f95e5379593c4d2dbc3213

不复杂但容易忽略。镜像配对 + 插件替换，这两步到位，Yii2 安装基本秒响应。