composer不能管理前端资源，它只负责php包；所谓“混合方案”本质是用scripts钩子调用npm/yarn。asset packagist自2025年底停更，npm-asset/*解析失败率高；fxp/composer-asset-plugin在composer 2.5+中报class not found；即使安装成功，文件散落vendor/、无dist/、无哈希、无法tree-shaking，且vendor/默认不被web服务器暴露。
Composer 不能管理前端资源，它只负责 PHP 包；所谓“混合方案”，本质是用 scripts 钩子调用 npm/yarn，不是让 Composer 去理解 JS/CSS。
为什么 composer require npm-asset/bootstrap 现在基本失效
Asset Packagist 自 2025 年底起停止更新，npm-asset/* 包解析失败率极高；fxp/composer-asset-plugin 在 Composer 2.5+ 中直接报 Class "Fxp\Composer\AssetPlugin\Repository\NpmRepository" not found。即使侥幸安装成功，文件仍散落在 vendor/npm-asset/bootstrap/，没有 dist/、不带哈希、无法 Tree-shaking，且 Web 服务器默认不暴露 vendor/ 目录。
post-install-cmd 脚本里怎么安全调用 npm
必须加路径判断和执行隔离，否则本地开发或 CI 环境容易中断：
- 用
@php -r包一层，兼容 Windows 和 Linux - 必须检查
package.json是否存在：file_exists('package.json') - 推荐用
npm ci（不是npm install）确保 lock 文件一致 - 构建目录需显式指定，例如
cd frontend && npm ci && npm run build，避免误操作根目录 - 不要把
npm install && npm run build写成单条命令——前者失败时后者仍会执行，错误被掩盖
PHP 模板里引用的路径决定你是否真解耦
模板中出现 /vendor/npm-asset/bootstrap/dist/css/bootstrap.min.css 这类路径，说明方案已经失控：
- 构建产物必须输出到
public/build/或public/dist/这类 Web 可访问目录 - PHP 代码只引用最终路径，如
<script src="/build/app.js"></script> -
node_modules/必须进.gitignore，它不是资产，是临时构建环境 - CI/CD 中必须预装 Node.js，
vendor/bin/npm不存在，也永远不会存在
最容易被忽略的点：构建命令（如 vite build）的输出路径、公共 URL 前缀、以及 public/ 目录是否真的由 Web 服务器映射为根路径——这三个地方任意一个配错，前端资源就 404，且错误不会出现在 Composer 日志里。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
