fxp/composer-asset-plugin已被弃用，应卸载并改用hiqdev/asset-packagist等替代方案或迁移到npm/yarn管理前端依赖，避免与Composer 2.x及PHP 8+兼容性问题。
fxp/composer-asset-plugin 已被弃用，别再装它
Yii2 项目中遇到 composer require 安装前端资源（如 jquery、bootstrap）失败，或提示 Could not parse version constraint，大概率是还在用已停更的 fxp/composer-asset-plugin。这个插件自 2019 年起停止维护，与 Composer 2.x 及 PHP 8+ 兼容性极差，且官方明确不推荐继续使用。
替代方案只有两个：
- 完全迁移到
npm或yarn管理前端依赖，通过自定义AssetBundle绑定node_modules中的文件 - 若必须走 Composer 加载 Bower/NPM 包（例如 legacy 项目），改用社区维护的
composer-asset-plugin分支（如hiqdev/asset-packagist），但需手动配置repositories
执行 composer global remove fxp/composer-asset-plugin 是第一步，否则后续所有 require 都可能卡在解析阶段。
安装插件时 require 和 require-dev 的区别直接影响部署
在 Yii2 中，composer require yiisoft/yii2-redis 默认写入 require 段，意味着该扩展在生产环境也必须存在；而 composer require --dev codeception/codeception 写入 require-dev，只用于本地测试。
容易踩的坑：
-
yii2-debug必须放在require-dev，否则上线后会暴露调试面板，且触发debug模块的自动加载开销 -
yiisoft/yii2-gii同样只能进require-dev，否则gii路由在生产环境可被任意访问 - 部署到线上时，务必用
composer install --no-dev，否则vendor/里会多出大量非运行时依赖，增大体积并引入安全隐患
插件安装后不生效？检查三个关键位置
运行 composer require kartik-v/yii2-detail-view 成功，但视图中调用 DetailView::widget() 报错 Class not found，问题通常不在 Composer，而在框架配置层。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
需要确认：
-
config/web.php的modules数组是否声明了该插件所需的模块（部分插件如yii2-admin需显式注册） -
components是否配置了插件依赖的服务（例如yii2-redis需配'redis' => ['class' => 'yii\redis\Connection']） - 是否遗漏迁移：某些插件（如
mdmsoft/yii2-admin）自带migrations，需手动执行php yii migrate --migrationPath=@vendor/mdmsoft/yii2-admin/migrations
前端资源路径发布失败：publishOptions 是关键开关
用 npm install bootstrap@5 安装后，在自定义 AppAsset 中设置 sourcePath => '@node_modules/bootstrap'，但页面加载 CSS 404 —— 这不是路径写错，而是 Asset Bundle 的发布机制没触发。
必须显式配置：
public $publishOptions = [
'forceCopy' => YII_DEBUG, // 开发期强制重发布，避免缓存旧文件
];
否则 Yii2 默认只在首次访问时发布一次，后续修改 JS/CSS 不会自动更新。另外，forceCopy 在生产环境应设为 false，靠 assetManager 的哈希命名机制保证版本一致性。
真正复杂的是混合路径场景：比如同时引用 node_modules/ 和 vendor/bower-asset/ 下的资源，publishOptions 的 beforeCopy 回调就变得不可绕过——它决定了哪些文件被跳过、哪些被重命名、哪些按需过滤。
