composer 和 npm/yarn 分属 php 与 js 生态，不能混用依赖；需通过 scripts（如 post-install-cmd）桥接构建流程，明确职责、避免重复安装、统一入口，并将构建产物加入 .gitignore。
Composer 和 npm/yarn 管理的是不同生态的依赖，不能直接混用或互相替代；协作的关键在于明确职责边界、避免重复构建、统一构建入口。
为什么不能把前端包丢进 composer.json 的 require 里
Composer 是 PHP 依赖管理器，只解析 Packagist 或自定义仓库中符合 PSR-4/PSR-0 的 PHP 包。npm/yarn 安装的 node_modules 里绝大多数是 JavaScript 模块（含 package.json、main 字段、ESM/CJS 导出），没有 autoload 配置，Composer 根本无法识别、加载或执行它们。
常见错误现象：composer require lodash 失败，报错 Could not find package lodash at any version；或者强行用 repositories 指向 npm registry，结果 autoload 失效、vendor/autoload.php 无法引入 JS 文件。
- PHP 代码不该直接
require()或importnode_modules下的 JS 文件 - 前端资源（CSS/JS）应通过构建流程产出，而非由 Composer 自动复制或链接
- 若硬要“集成”，只能靠脚本桥接（如
post-install-cmd触发yarn install），但这是协作起点，不是依赖合并
scripts 中调用 yarn 或 npm 的正确姿势
Composer 的 scripts 是最常用、最轻量的协作点，适合在 PHP 项目构建生命周期中嵌入前端构建步骤。关键是用好 post-install-cmd 和 post-update-cmd，并确保命令可重复执行、有容错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
示例 composer.json 片段：
"scripts": {
"post-install-cmd": [
"[ -d node_modules ] || yarn install --frozen-lockfile",
"yarn run build"
],
"post-update-cmd": [
"yarn install --frozen-lockfile",
"yarn run build"
]
}
- 用
[ -d node_modules ] || ...避免每次composer install都重装node_modules（尤其 CI 环境） -
--frozen-lockfile防止意外升级，保持前端依赖确定性 - 不要写
"yarn && yarn build"—— 前者失败时后者仍会执行；用数组形式可逐条控制 - 如果项目用 npm，把
yarn全部换成npm，但注意npm ci才等价于yarn install --frozen-lockfile
如何让 public/ 下的静态资源不被误提交或污染
前端构建产物（如 public/build/app.js、public/css/main.css）必须由构建生成，绝不能手动编辑或提交到 Git。否则会导致：PHP 部署时覆盖构建结果、多人协作冲突、CI 构建行为不一致。
- 把构建目录（如
public/build/）加入.gitignore，同时保留public/build/.gitkeep占位（避免目录被删） - 在
composer.json的scripts中，构建前先清空目标目录：rm -rf public/build && yarn run build - 若用 Laravel Mix，确保
webpack.mix.js输出路径指向public/下子目录，而非根目录（避免污染public/index.php） - CI 流程中，先
composer install --no-dev，再yarn install --frozen-lockfile && yarn run production，顺序不能反
真正容易被忽略的是环境差异：本地开发可能全局装了 yarn，但 Docker 或生产服务器上没装，或版本不兼容。协作脚本里最好显式检查 yarn --version，或统一用 npm 降低工具链复杂度。另外，别忘了给 package.json 的 engines 字段锁 Node.js 版本，否则 yarn install 在不同机器上行为可能不一致。
