Composer 不再支持 Bower 前端资产管理，fxp/composer-asset-plugin 在 Composer 2.x 中彻底失效，应改用 npm + 构建脚本将资源导出至 public/assets/ 目录并更新 AssetBundle 引用。
Composer 本身不管理前端资产，Bower 已于 2017 年归档，fxp/composer-asset-plugin 在 Composer 2.x 中彻底不可用——你不能再靠它拉取 bower-asset/jquery 或同步 vendor/bower-asset/ 目录。
为什么 bower-asset/xxx 依赖现在基本失效
常见错误现象：composer require bower-asset/bootstrap 成功但 vendor/bower-asset/bootstrap/ 下没有 dist/ 文件，模板中引用 /vendor/bower-asset/bootstrap/dist/css/bootstrap.min.css 直接 404。
- Bower 官方 registry（
https://bower.herokuapp.com）已关闭，多数镜像服务（如registry.bower.io）也停止维护或返回ENOTFOUND -
fxp/composer-asset-plugin依赖 Composer 1.x 内部 API，PHP 8.1+ 下常报Class "Fxp\Composer\AssetPlugin\Repository\NpmRepository" not found - Composer 2.2+ 默认禁用 asset-type 依赖，需手动加
"config": {"platform": {"php": "7.4"}}}模拟旧环境，徒增兼容性风险 - 即使侥幸装上，Bower 包普遍缺失
main字段，插件无法自动识别应复制的 JS/CSS 入口文件
迁移路径：从 bower-asset/xxx 到 npm install + 构建脚本
核心原则：PHP 和前端资源物理隔离，Composer 只触发，不下载。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 删掉
composer.json中所有bower-asset/和npm-asset/条目，移除repositories里指向asset-packagist.org或私有 Bower 源的配置 - 在项目根目录新建
package.json，写入真实依赖：npm init -y && npm install bootstrap jquery --save-prod - 用最简构建脚本把产物导出到 PHP 可访问路径，例如在
composer.json的scripts中添加："post-install-cmd": ["npm install", "mkdir -p public/assets/js public/assets/css", "cp node_modules/bootstrap/dist/js/bootstrap.min.js public/assets/js/", "cp node_modules/bootstrap/dist/css/bootstrap.min.css public/assets/css/"]
- 若项目已有
public/assets/目录且被 Git 跟踪，记得在.gitignore中排除node_modules/和package-lock.json，只提交构建产物（如public/assets/js/bootstrap.min.js）
遗留 Yii2 项目如何平滑过渡
如果你的项目仍依赖 vendor/bower-asset/ 结构（比如 Yii2 的 AssetBundle 类硬编码了该路径），不能直接删除插件。
立即学习“前端免费学习笔记（深入）”；
- 先确认是否真需要运行时动态加载——大多数情况下，只需把
vendor/bower-asset/jquery/替换为public/assets/js/jquery.min.js，再改写对应AssetBundle::js数组即可 - 不要保留
fxp/composer-asset-plugin，改用composer install后执行的 shell 脚本模拟原行为：#!/bin/sh\nmkdir -p vendor/bower-asset/jquery\ncp public/assets/js/jquery.min.js vendor/bower-asset/jquery/
- Yii2 的
AssetManager支持linkAssets和forceCopy，可设为false避免每次请求都检查文件是否存在，性能影响比想象中小
真正难的不是替换命令，而是清理模板里那些隐式依赖 Bower 目录结构的路径引用，以及 AssetBundle 中未声明版本却靠插件自动解析的 main 字段逻辑——这些不会报错，但会在某次 composer update 后突然失效。
