Composer不自动复制JS/CSS到Web目录，需配置post-install-cmd等脚本搬运；必须加目录存在性判断、跨平台兼容处理及Node.js环境检查，否则易中断或失效。
Composer 不会自动发布或复制 JS/CSS 等资源文件到 Web 可访问目录，它只负责把包下载进 vendor/；所谓“管理静态资源”，本质是靠你主动配置脚本、插件或构建工具来搬运或生成它们。
post-install-cmd 脚本复制资源时路径判断必须加
直接写 cp -r vendor/twbs/bootstrap/dist public/css/bootstrap 很危险：一旦包没提供 dist/ 目录（比如只含源码或用 ES 模块组织），命令报错会导致 composer install 中断。
- 务必包裹
if [ -d "vendor/twbs/bootstrap/dist" ]; then ... fi判断 - Linux/macOS 用
cp -r，Windows CI 环境需改用xcopy或启用 WSL，否则构建失败 - 目标目录建议先
mkdir -p public/vendor/bootstrap，避免因父目录不存在而静默失败 - 别在脚本里写
rm -rf public/vendor—— 容易误删你自己维护的组件
用 asset-packagist.org 时 extra.asset-installer-paths 必须配对
只加仓库源和 require 不够，extra.asset-installer-paths 是触发文件拷贝的关键开关，漏配等于白装。
- 格式必须是
{"public/css/{$name}": ["npm-asset/bootstrap"]}，其中{$name}会被自动替换为包名 - 不能写成
{"public/css/bootstrap": ["*"]}——*不被识别，路径不会展开 - 如果同时引入多个 npm 包，每个都要显式列在数组里，如
["npm-asset/jquery", "npm-asset/bootstrap"] - 插件本身不处理
node_modules，它只从 CDN 下载预构建压缩包，所以不依赖 Node.js 环境
scripts 里调用 npm 命令前要确认环境是否就绪
post-install-cmd 中写 npm install 或 npm run build 看似简单，但实际部署中极易卡住——因为 Composer 不检查 Node.js 是否存在。
- 必须加
file_exists('package.json')判断，否则无前端配置时脚本直接报错退出 - 推荐用
@php -r "if (file_exists('package.json')) echo `npm install`;"包一层，兼容 Windows - Docker 镜像或生产服务器若没预装 Node.js，该脚本会静默失败（返回非零码但不中断流程），导致
public/js/app.js缺失却无提示 - CI/CD 中应显式检查
which node && which npm，而不是依赖 Composer 脚本兜底
vendor/bin/npm 不存在，别被名字误导
有人尝试在 scripts 里写 vendor/bin/npm install，结果报 command not found —— 这是因为 Composer 从不安装 npm，它不是 PHP 包。
-
npm是 Node.js 运行时的一部分，必须由操作系统级安装（apt install nodejs npm或nvm） -
composer require npm必然失败，Packagist 上没有叫npm的合法包 - 所谓“集成 npm”，只是调用系统命令，不是把 npm 当 Composer 依赖来管理
- 若服务器禁止 root 权限且未预装 Node.js，这条路走不通，得提前打包构建产物或换用 asset-packagist 方案
最常被忽略的一点：所有脚本钩子（post-install-cmd、post-update-cmd）默认在本地执行，不会自动同步到生产环境；如果你用 composer install --no-scripts 或 CI 流程跳过脚本，那些 cp 和 npm run build 就根本不会发生。
