Composer不直接管理前端依赖，应与npm/yarn分工协作：前者管PHP包至vendor/，后者管JS/CSS至node_modules/，通过composer.json的scripts钩子（如post-install-cmd）调用npm ci && npm run build，将构建产物输出到public/build等Web可访问目录。
Composer 不能直接管理 Web 应用的前端依赖，它只负责 vendor/ 下的 PHP 包；所谓“用 Composer 管理 JS/CSS”，本质是绕过它的设计边界，靠外部机制补位——现在（2026 年）最稳妥的做法，是让 Composer 和 npm/yarn 各管一摊，再用脚本粘合。
composer require npm-asset/jquery 为什么没生成任何 JS 文件
因为 npm-asset/jquery 只是把 jQuery 源码下载到 vendor/npm-asset/jquery/，不执行构建、不复制、不链接。它连 dist/ 目录都不保证存在——有些包源码里根本没预编译文件，得靠 npm run build 生成。
- 你看到
vendor/npm-asset/jquery/package.json，不代表它能直接在浏览器运行 - 如果包里没有
dist/jquery.min.js，cp命令会失败，但 Composer 不报错 -
npm-asset/*包依赖声明（如 Bootstrap 依赖 jQuery）只在 Composer 层生效，不影响浏览器加载顺序
fxp/composer-asset-plugin 已彻底失效
该插件在 Composer 2.x+ 中无法加载，报错典型为 Class "Fxp\Composer\AssetPlugin\Repository\NpmRepository" not found。它依赖已移除的 Composer 1.x 内部 API，且不支持 ESM、exports 字段等现代 npm 特性。
- 别试
composer global require fxp/composer-asset-plugin，2026 年所有主流 CI 环境都会卡住 - Asset Packagist（
https://asset-packagist.org）虽仍可访问，但元数据更新停滞，很多新版本 npm 包缺失或指向 404 - 强行配置
"type": "bower-asset"或伪造仓库，只会让composer update变慢并产生不可预测的路径错误
推荐做法：用 composer.json scripts 驱动 npm 流程
在 composer.json 的 scripts 块中定义钩子，把前端构建纳入 Composer 生命周期，但不越界接管 npm 本身。
立即学习“前端免费学习笔记（深入）”；
- 确保项目根目录有
package.json，且已声明"build"脚本（如"build": "vite build"或"build": "webpack --mode=production"） - 在
composer.json中添加："scripts": { "post-install-cmd": ["@php -r \"file_exists('package.json') && system('npm ci && npm run build');\""], "post-update-cmd": ["@php -r \"file_exists('package.json') && system('npm ci && npm run build');\""] } -
npm ci比npm install更可靠，它严格按package-lock.json安装，避免本地node_modules权限污染 CI 环境 - 构建产物（如
dist/或public/build/）必须明确写入 Web 服务器可访问路径，PHP 模板里引用<script src="/build/app.abc123.js"></script>，而非从vendor/动态读取
老项目迁移时最容易忽略的点
Yii2 或旧 Laravel 项目若曾依赖 fxp 插件生成的 vendor/bower-asset/，直接删掉相关配置还不够——你得确认模板里所有 src="/assets/jquery/jquery.min.js" 这类路径，是否已切换为指向构建产物的实际 URL。
-
.gitignore必须包含node_modules/和原始src/前端目录，只提交package-lock.json和构建后的public/build/ - CI 流水线要显式安装 Node.js（如 GitHub Actions 中用
actions/setup-node），不能指望 Composer 自带环境 - 本地开发时，别用
composer update触发完整构建；改用npm run dev实时监听，否则每次 PHP 依赖更新都重跑一遍 vite 构建，纯属浪费时间
