Composer与NPM/Yarn应职责分离、路径隔离、流程协同：前者管PHP依赖（src/app→vendor），后者管前端资源（resources→public/build），锁文件必提交，构建后仅发布PHP代码和静态产物。
Composer 和 Node.js 工具（NPM/Yarn）服务不同层级：Composer 管理 PHP 依赖，NPM/Yarn 管理前端资源（JS/CSS/构建工具）。它们可以共存，关键在于职责分离、路径隔离和流程协同。
明确各自作用域，避免混用
不要让 Composer 安装前端包（如通过 fxp/composer-asset-plugin），也不要用 NPM 管理 PHP 类库。现代项目中，PHP 后端和前端资源应物理分离：
- PHP 源码放在
src/或app/，由 Composer 安装到vendor/ - 前端代码放在
resources/js/、resources/css/，由 NPM/Yarn 管理依赖，构建产物输出到public/build/或web/assets/ - 确保
vendor/和node_modules/都在 .gitignore 中，但composer.lock和package-lock.json（或yarn.lock）必须提交
统一构建与部署流程
在 CI/CD 或本地部署时，需按顺序执行依赖安装和构建：
- 先运行
composer install --no-dev（生产环境）或composer install（开发） - 再运行
yarn install --frozen-lockfile（推荐）或npm ci，确保依赖一致性 - 接着执行构建命令，如
yarn run build（Vite/Webpack）生成静态文件 - 最后将 PHP 文件 + 构建后的
public/build/一起发布，不上传node_modules/
共享配置与环境变量（谨慎处理）
前后端可能需要共用 API 地址、调试开关等。避免硬编码，推荐方式：
- PHP 侧通过
.env（用vizual/vlucas/phpdotenv加载）定义API_BASE_URL=http://api.example.com - 前端构建时，用 Webpack DefinePlugin 或 Vite 的
import.meta.env注入相同值（从同一份.env或 CI 变量读取） - 不建议让 Composer 脚本调用
yarn，也不建议在package.json的postinstall中执行 PHP 命令——耦合过重，失败难排查
开发体验优化小技巧
提升双环境协作效率：
- 用
concurrently或npm-run-all启动 PHP 开发服务器（如php -S localhost:8000 router.php）和前端热更新服务（vite） - 在
composer.json的scripts中定义快捷命令，如"dev": "concurrently \"php -S localhost:8000 router.php\" \"yarn dev\"" - 若使用 Laravel Mix/Vite，其默认会监听
resources/变更并自动刷新，无需额外集成 Composer 监听
基本上就这些。核心是“各管一段，流程串起，配置对齐”。不复杂但容易忽略的是锁文件管理和构建产物路径约定——定好这两点，协作就很顺了。
