composer本身不管理静态资源，正确做法是用npm/yarn处理css/js等前端依赖，composer仅通过post-install-cmd等钩子触发构建；必须避免将静态文件纳入autoload，防止扫描卡顿、classmap膨胀及部署冗余。
Composer 本身不处理静态资源（CSS/JS/图片），所谓“分离加载”是误用概念；真正要解决的是：如何让大型 PHP 项目在不拖慢启动、不污染 vendor 的前提下，安全接入含大量静态文件的第三方包（如 AdminLTE、Bootstrap、CKEditor 等）。
为什么直接 require "twbs/bootstrap" 会出问题
这类包通常体积大（>10MB）、文件多（数千个）、含大量非 PHP 文件（.css/.js/.map/.svg），但 Composer 默认行为是：把整个包解压到 vendor/twbs/bootstrap/，并可能被 autoload 错误扫描或映射，导致：
-
composer install --optimize-autoloader扫描时卡住（遍历上万文件） -
autoload_classmap.php被塞入大量无关路径（如dist/css/bootstrap.min.css），体积暴涨至 5–10MB - OPcache 缓存失效频繁（大文件变动触发重编译）
- 部署时把前端资源一起打包上传，浪费带宽和构建时间
正确做法：用 fxp/composer-asset-plugin 或 npm 替代 Composer 管理前端资源
Composer 不是前端包管理器。强行用它装 Bootstrap，等于让快递员帮你铺地板砖——能干，但极低效且易出错。应明确分工：
- PHP 逻辑层（类、接口、命令）→ 用 Composer 管理，严格配置
autoload和--classmap-authoritative - 静态资源层（CSS/JS/fonts）→ 用
npm或yarn安装到resources/assets/，再由构建工具（Webpack/Vite）处理 - 若必须走 Composer（如遗留 Yii1 项目），则用
fxp/composer-asset-plugin，它会：
• 把 npm-asset/bootstrap 映射到独立目录（如 web/assets/bootstrap/）
• 自动忽略非 PHP 文件，不参与 autoload 扫描
• 支持 asset-installer-paths 配置，避免污染 vendor/
composer.json 中必须删掉的危险配置
以下写法会让 Composer 把静态资源卷进 autoload 流程，务必删除：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"autoload": {"psr-4": {"": "vendor/twbs/bootstrap/dist/"}}—— 绝对禁止，命名空间为空会扫全目录 -
"autoload": {"classmap": ["vendor/twbs/bootstrap/"]}—— classmap 会递归扫描所有 .php + .js + .css，生成巨量无效映射 -
"autoload-dev": {"files": ["vendor/twbs/bootstrap/dist/js/bootstrap.bundle.js"]}——files加载绕过 classmap，且无法被--classmap-authoritative控制，运行时直接require_once失败
正确做法是：静态资源只通过 Web 服务器路径访问（如 /assets/bootstrap/css/bootstrap.min.css），不参与 PHP autoloading。
CI/CD 中如何隔离静态资源与 PHP 构建
生产部署时，应拆开两步，避免把前端资源打进 PHP 运行镜像：
- PHP 构建阶段：
composer install --no-dev --optimize-autoloader --classmap-authoritative，不执行 npm install - 前端构建阶段：单独 Docker stage 或 CI job，运行
npm ci && npm run build，输出到public/assets/ - 最终镜像只合并 PHP
vendor/+ 编译后的public/assets/，体积可减少 60%+
关键点：不要让 Composer 承担它不该管的事；静态资源的“分离”，本质是职责分离，不是技术技巧。
