Composer 和 npm 是 PHP 与 JavaScript 生态各自不可互换的依赖管理工具，因加载机制根本不同而无法替代：Composer 生成 autoload.php 实现 PHP 类自动加载，npm 包不参与 PHP 加载且无对应入口。

Composer 和 npm 不是“差不多的工具”，而是各自语言生态里不可互换的基础设施：一个专治 PHP 依赖，一个专管 JavaScript 生态。选错就等于让 PHP 项目去调用 node_modules 里的类，或者让 Vue 组件试图 require vendor 下的 Laravel Facade——根本跑不起来。

为什么不能把 npm 当 Composer 用（或反过来）

根本原因在于加载机制完全不同：Composer 通过 autoload 规则生成 vendor/autoload.php，PHP 运行时靠它自动定位类文件；而 npm 安装的包默认不参与 PHP 的自动加载，也不会生成任何 PHP 可识别的入口。
常见错误现象：
• 在 composer.json 里写 "vue": "^3.4"，执行 composer install 报错 “Package not found”
• 把 package.json 放进 vendor/ 目录下，以为能“统一管理”，结果部署时 npm install 失败，因为 vendor/ 通常被 .gitignore 排除
• 在 PHP 代码里直接 require 'node_modules/vue/dist/vue.esm-bundler.js' —— 路径可能对，但浏览器不会执行，服务端又不需要这个 JS

怎么让 Composer 和 npm 在同一个 PHP 项目里不打架

关键不是“合并”，而是“分工+衔接”。现代 Laravel/Symfony 项目就是这么干的：
• composer.json 管所有 PHP 包（laravel/framework、guzzlehttp/guzzle），安装到 vendor/
• package.json 管所有前端资源（vue、axios、tailwindcss），安装到 node_modules/，构建输出到 public/build/
• 用 composer.json 的 scripts 字段触发前端流程：

"scripts": {<br>  "post-install-cmd": ["@php artisan vendor:publish --tag=laravel-assets", "npm install && npm run build"],<br>  "post-update-cmd": ["npm ci && npm run build"]<br>}

⚠️ 注意：npm ci 比 npm install 更可靠，它强制按 package-lock.json 安装，避免本地 node_modules 差异影响构建结果

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

lock 文件必须提交，否则协作必崩

composer.lock 和 package-lock.json 不是可选配置，是环境一致性的底线：
• composer install 读 composer.lock，跳过版本解析；没 lock 文件时，composer install 行为等同于 composer update，可能拉下不兼容的新版 PHP 包
• 同理，没 package-lock.json，不同人 npm install 可能装出不同版本的 webpack 或 postcss，导致 CSS 构建结果不一致、甚至 JS 报 Cannot resolve 'xxx'
• CI/CD 流程中必须分两步：

• composer install --no-dev --optimize-autoloader
• npm ci && npm run prod

跳过任意一步，上线后页面白屏或接口 500 都不奇怪

全局安装只适合 CLI 工具，别碰项目依赖

npm -g 装的是命令行工具，比如 create-react-app 或 serve；composer global require laravel/installer 装的是 laravel new 命令本身。它们都不该出现在项目运行时依赖链里：
• 全局 npm 包不会写入 package.json，CI 环境里默认没有，一跑就报 command not found
• 全局 composer 包不会进 vendor/，PHP 代码里 use 不到，也进不了自动加载器
• 正确做法：开发期 CLI 工具用全局，项目运行期依赖全走本地 composer.json / package.json

真正容易被忽略的，是构建产物路径和权限问题：Laravel 默认从 public/build/ 加载 JS/CSS，但如果你在 package.json 里配了 output.path: 'public/dist'，却没改模板里的 <script src="/build/app.js"></script>，那再准的 composer + npm 协同也没用。