PHP负责后端API，Node.js构建前端资源，Composer管理PHP包、NPM管理前端依赖；需目录隔离（如/src/、/public/、/frontend/）、明确构建时机（先前端build再复制至/public/build/，后composer install）、自动化部署，并忽略vendor/、node_modules/、frontend/dist/，保留lock文件确保依赖可重现。
前后端分离项目里，PHP负责后端API，前端资源（JS/CSS/图片等）由Node.js构建，Composer管PHP包，NPM管前端工具和库——两者职责分明，但需协同工作，关键在于目录隔离、构建时机明确、部署流程自动化。
目录结构要清晰隔离
避免把node_modules和vendor混在一起，也别让前端构建产物污染PHP源码。推荐结构：
-
/src/—— PHP后端代码（含Controller、Model等） -
/public/—— Web根目录，存放index.php和最终静态资源 -
/frontend/—— 独立前端工程（含package.json、src/、dist/等） -
/public/build/—— 前端构建输出目标（由frontend的build脚本复制或生成）
这样Composer只操作vendor/，NPM只在frontend/内运行，互不干扰。
构建流程分两步，用脚本串联
开发时手动执行没问题，CI/CD或部署时必须自动化。可在项目根目录加一个build.sh或Makefile：
立即学习“PHP免费学习笔记（深入）”；
- 先
cd frontend && npm ci && npm run build（生产构建） - 再把
frontend/dist/*复制到public/build/（可用rsync或cp -r） - 最后
composer install --no-dev --optimize-autoloader（后端依赖）
PHP框架如Laravel默认已支持从public/build/加载JS/CSS，只需在模板中用<script src="/build/app.js"></script>即可。
用于自动切换项目中适合的node 版本
下载
根据 package.json 中的 engines 字段自动检测 Node.js 版本需求，未安装 nvm 时自动安装并切换至对应版本。支持 Windows、macOS、Linux。适用于 Node.js 项目开发、版本切换和环境配置。
Git忽略策略要写全
防止误提交大体积依赖：
-
vendor/和node_modules/都进.gitignore -
frontend/dist/也忽略（构建产物不进版本库） - 但保留
frontend/package-lock.json和composer.lock——它们保证依赖可重现
团队成员只需git clone后运行一次./build.sh，就能得到完整可运行环境。
部署时注意权限与路径
上线服务器上，npm不一定预装，也不建议在生产机跑npm install。稳妥做法：
- 在CI机器（如GitHub Actions、GitLab CI）完成全部构建，打包
public/build/和vendor/ - 只上传精简后的
public/、src/、config/等必要目录到生产机 - 确保Web服务器（Nginx/Apache）根目录指向
public/，且public/build/可被直接访问
PHP-FPM无需知道NPM存在，前端资源对它只是静态文件。
基本上就这些。不复杂但容易忽略的是构建顺序和路径映射——只要目录分清、脚本跑通、锁文件留好，Composer和NPM就能各干各的，稳稳配合。
