composer 是 php 依赖管理器，yarn 是 javascript 包管理器，二者技术栈不同、不可替代；需分层协作：composer 管后端逻辑与自动加载，yarn 管前端构建与资源输出，共存关键在流程隔离与路径对齐。
Composer 和 Yarn 不是同一类工具，不能互相替代
Composer 是 PHP 的依赖管理器，Yarn 是 JavaScript 生态的包管理器——它们压根不在一个技术栈里运行，强行对比就像问“电饭锅和咖啡机哪个煮得更快”。composer install 装的是 monolog/monolog 这类 PHP 类库，生成 vendor/ 目录并写好自动加载；yarn install 装的是 vue 或 tailwindcss，产出 node_modules/ 并为构建工具（如 Vite、Webpack）提供基础。
常见错误现象：
• 在 composer.json 里写 "vue": "^3.4"，结果 composer update 报错“Package not found”
• 把 package.json 删了只留 composer.lock，前端资源编译直接失败，页面空白但控制台无报错
- 使用场景：PHP 后端逻辑用 Composer；JS/CSS/字体/图标等静态资源用 Yarn（或 npm）
- 参数差异：
composer require foo/bar修改composer.json并更新vendor/；yarn add foo-bar修改package.json并更新node_modules/，二者不共享配置项、不读取对方的 lock 文件 - 性能影响：混用时若没隔离构建流程，CI 中可能重复下载两套依赖，拉长构建时间；本地开发若
yarn build输出路径写错，PHP 模板引入的<script src="build/app.js"></script>就会 404
怎么让 Composer 和 Yarn 在一个项目里不打架
关键不是“统一管理”，而是“分层协作”：Composer 管 PHP 生命周期（安装、自动加载、命令行工具注册），Yarn 管前端资产生命周期（下载、编译、哈希重命名、输出到 public/build/）。
实操建议：
• 在 composer.json 的 "scripts" 里加钩子：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
"post-install-cmd": ["yarn install", "yarn run build"],<br>"post-update-cmd": ["yarn install", "yarn run build"]
• 构建脚本（
package.json 中）必须输出到 PHP Web 根目录下可公开访问的路径，比如 "build": "vite build --outDir ../public/build"- 容易踩的坑：Yarn 构建命令没设
--outDir，默认输出到dist/，PHP 模板却硬编码引用/build/，上线后 JS/CSS 全 404 - 兼容性影响：某些老旧部署脚本只执行
composer install，忘了跑yarn install，导致构建产物缺失；建议 CI 流程中显式写两行：composer install --no-dev+yarn install --frozen-lockfile && yarn run build - 版本锁定必须双份：
composer.lock和yarn.lock都要提交，缺一不可；删掉yarn.lock再yarn install，很可能装上新版lodash导致 Vue 组件报Cannot read property 'xxx' of undefined
为什么不用 Composer 直接装前端库（比如 bootstrap）
有历史尝试（如 components/bootstrap 这类老式 Composer 包），但已被主流放弃。原因很实在：前端资源需要构建步骤（转译、压缩、CSS 提取、代码分割），而 Composer 没有执行能力，也不理解 import、require()、@layer 这些语法。
典型错误现象：
• 用 composer require twbs/bootstrap 装完，发现只有 CSS 和 JS 源码，没有编译，也没法按需引入 Alert 组件
• 手动把 vendor/twbs/bootstrap/dist/ 复制进 public/，但后续升级 Bootstrap 时，得再手动复制，且无法和自定义 SCSS 合并
- 现代做法：Yarn 安装
bootstrap+sass，在resources/scss/app.scss里@import "~bootstrap/scss/alert"，由 Vite 编译进单个app.css - 性能代价：绕过构建直接引用
vendor/下的未压缩文件，会导致 HTML 体积膨胀、HTTP 请求增多、Lighthouse 评分暴跌 - 维护成本：一旦项目引入了 ES 模块语法或 PostCSS 插件，Composer 管理的前端资源就彻底失能
CI/CD 中漏掉 Yarn 步骤会出什么问题
不是“功能不全”，而是“静态资源彻底消失”——PHP 后端一切正常，php artisan serve 能打开首页，但所有按钮没交互、样式全失效、控制台刷满 Failed to load resource: the server responded with a status of 404 ()。
真实案例：
• GitHub Actions workflow 只写了 - run: composer install，忘了 yarn install && yarn build，合并 PR 后生产环境白屏
• 部署脚本用 rsync -av --exclude='node_modules' ./ user@server:/var/www，但没同步 public/build/，因为构建是在本地做的，而本地 public/build/ 被 gitignore 了
- 解决方案：构建必须在目标环境（或镜像内）完成，不能依赖本地产物；
public/build/不进 Git，但必须由 CI 生成并上传 - 检查点：上线前 curl 一下
/build/app.js和/build/app.css，状态码不是 200 就立刻回滚 - 最容易被忽略的地方：.gitignore 里写了
node_modules/和public/build/，是对的；但很多人忘了在 CI 的cache配置里排除node_modules/，导致缓存污染，某次yarn install卡死或装错版本
