是，Composer 默认且强制忽略 node_modules；它只管理 PHP 依赖，不读取 package.json 或执行 npm，除非显式配置 scripts 钩子。
composer install 会忽略 node_modules 吗
会，而且是默认且强制的。Composer 的 install 和 update 过程完全不感知 node_modules，也不会读取 package.json 或执行 npm 命令——除非你显式配置了脚本钩子。
常见错误现象：
– 项目里写了 package.json，但 composer install 后发现 public/js/app.js 没生成
– 误以为 Composer 自带前端构建能力，结果部署失败
- Composer 管理的是 PHP 依赖，不是前端工具链
-
node_modules属于构建产物/临时目录，应被.gitignore排除，也不该提交进包 - 若想让 Composer 触发 npm，必须靠
scripts配置，且需确保目标机器已安装 Node.js 和 npm
在 composer.json 里调用 npm install 的正确写法
核心是利用 Composer 的 scripts 字段，在 post-install-cmd 或 post-update-cmd 阶段执行 shell 命令。
使用场景：Laravel、Symfony 等 PHP 框架项目中需同步拉取前端依赖并构建资源
立即学习“前端免费学习笔记（深入）”；
"scripts": {
"post-install-cmd": [
"@php -r \"if (file_exists('package.json')) echo `npm install`;"
],
"post-update-cmd": [
"@php -r \"if (file_exists('package.json')) echo `npm run build`;\""
]
}
- 用
@php -r包一层是为了兼容 Windows（直接写npm install在 Windows 下可能失败） - 务必加
file_exists('package.json')判断，否则无前端配置时会报错中断 - 不要写成
"npm install && npm run build"——一旦install失败，build不会执行，但错误容易被忽略 - CI/CD 中要注意：Docker 容器或部署机必须预装 Node.js，否则脚本直接退出
为什么 vendor/bin/npm 不能替代系统 npm
因为 Composer 不提供 vendor/bin/npm。这是个常见误解——npm 是 Node.js 运行时的一部分，不是 PHP 包，不会被安装到 vendor/ 下。
错误现象：
– 在 composer.json 脚本里写 vendor/bin/npm install，提示 command not found
– 尝试用 composer require npm，报错 “Package not found”
-
npm必须由操作系统级安装（apt install nodejs npm或 nvm） - PHP 项目里所谓“集成 npm”，只是调用系统命令，不是把 npm 当作 Composer 包来管理
- 如果服务器禁止 root 权限，又没预装 Node.js，这条路就走不通，得换方案（比如构建产物提前打包）
更稳妥的替代方案：构建产物而非源码交付
比起让 Composer 在生产环境跑 npm install，更推荐把前端构建完成后的静态文件（如 public/build/）纳入发布流程。
适用条件：
– 生产服务器无法安装 Node.js
– CI 流水线已支持多语言构建（如 GitHub Actions 先 npm build，再 composer install）
– 团队对前后端职责划分明确
- 前端代码和构建逻辑保留在同一仓库，但
composer install只负责 PHP 部分 - 构建产物（如
public/css/app.css）应加入 Git，避免部署时不可控 - 若用 Laravel Mix/Vite，可在
package.json的build脚本里指定输出路径为public/build/，PHP 直接引用即可 - 注意清理旧产物：
npm run build -- --emptyOutDir或手动rm -rf public/build再构建
真正麻烦的从来不是怎么写那几行 script，而是 Node.js 版本漂移、npm registry 切换、CI 缓存失效这些隐性成本。一旦团队里有人开始问“为什么本地能装 npm install，线上就不行”，说明环境一致性已经失控了。
