fxp/composer-asset-plugin 已废弃且无法安装，因其不兼容 php 7.4+ 和 composer 2.x，依赖下线仓库且自 2019 年停止维护；应改用 npm/yarn 管理前端资源，composer 专注 php 依赖。
Composer 本身不管理前端静态资源，fxp/composer-asset-plugin 是一个已废弃的、历史遗留的“跨界补丁”，它强行让 Composer 去下载 Bower/NPM 包，现在不仅无效，还会引发依赖冲突和安装失败。
为什么 fxp/composer-asset-plugin 现在根本装不上
PHP 7.4+ 和 Composer 2.x 完全不兼容该插件。它依赖已下线的 bower-asset 和 npm-asset 类型仓库，且其核心包 fxp/composer-asset-plugin 自 2019 年起停止维护，GitHub 仓库已归档。
- 运行
composer global require fxp/composer-asset-plugin会报Root composer.json requires fxp/composer-asset-plugin ^1.4.6 -> could not be found - 即使降级到 Composer 1.x，也会因 Packagist 移除相关元数据而卡在
Loading repository - Yii 2 项目若仍保留该插件配置，
composer install会静默跳过 asset 包，导致yii\web\AssetBundle报file not found
替代方案：用原生工具管前端资源，Composer 只管 PHP
现代做法是把职责切开：Composer 专注 PHP 依赖，前端资源交给 npm 或 yarn 管理，再通过构建步骤（如 npm run build）把产出物复制进 web/assets/ 或类似路径供 PHP 加载。
- 删除
composer.json中所有"extra": {"asset-installer-paths": {...}}配置 - 在项目根目录初始化
package.json，用npm install jquery@3.6.0 bootstrap@5.3.3安装所需库 - 用
copyfiles或简单 shell 脚本把node_modules/jquery/dist/jquery.min.js复制到web/js/jquery.min.js - Yii 2 中的
AppAsset改为引用web/js/jquery.min.js，而非试图从@bower加载
如果必须兼容老 Yii 2 项目，怎么最小化改造
不是恢复 fxp，而是绕过它——用符号链接或脚本模拟旧路径结构，让 AssetBundle 不报错，同时彻底弃用其安装逻辑。
立即学习“前端免费学习笔记（深入）”；
- 创建空目录
vendor/bower/jquery，并在其中放一个jquery.min.js（可从 CDN 下载） - 在
composer.json的"scripts"里加"post-install-cmd": ["mkdir -p vendor/bower && ln -sf ../node_modules/jquery vendor/bower/jquery"]（Linux/macOS） - Windows 用户改用 PowerShell 脚本或直接复制，避免
ln失败 - 确认
Yii::getAlias('@bower')指向vendor/bower，否则在config/web.php显式设置'aliases' => ['@bower' => '@vendor/bower']
真正麻烦的从来不是“怎么让 Composer 下 JS”，而是没想清楚：PHP 生态和前端生态的边界在哪。一旦开始用 fxp，就等于把两套版本管理体系硬拧在一起，后面每个 composer update 都可能崩掉前端路径。现在删干净，比修三天兼容性更省时间。
