答案是必须在项目根目录执行composer require，否则会因找不到composer.json或误操作配置文件导致错误；需显式指定版本号、及时dump-autoload刷新映射，并验证PHP扩展与镜像源配置。
直接用 composer require 就行，别先改 composer.json 再跑 composer install —— 这是最容易出错的路径。
为什么必须在项目根目录执行 composer require
Composer 会读取当前目录下的 composer.json 并写入依赖项；如果不在根目录，它要么报错“Could not find composer.json”，要么误操作到上级或子项目的配置文件里。
- 常见错误现象：终端提示
No composer.json found in the current directory，但你明明看到文件存在 → 检查是否 cd 进错了目录，或文件名是composer.json.bak这类非标准命名 - 运行前确认：执行
ls -la | grep composer.json（Linux/macOS）或dir composer.json（Windows） - 如果项目还没
composer.json，先运行composer init生成，不要跳过这步硬写
composer require 带版本号和选项的实际用法
不加版本号默认装最新稳定版（^ 约束），但线上项目必须显式控制范围，否则下次 composer update 可能升破兼容性。
- 装指定兼容版本：
composer require monolog/monolog:^3.5（允许 3.5.x，不升 4.x） - 只装开发期依赖：
composer require --dev phpunit/phpunit:^10.5，这样生产部署加--no-dev就自动跳过 - 临时绕过 PHP 版本检查（仅调试用）：
composer require --ignore-platform-reqs ext-gd，但上线前必须解决真实约束冲突 - 强制重装并更新依赖树：
composer require --update-with-dependencies friendsofphp/php-cs-fixer，适合怀疑 vendor 损坏时
装完后类为啥还是找不到？autoload 没刷新
哪怕 vendor/autoload.php 已存在，新包的类也不会被识别——因为 Composer 的 autoload 映射没重建。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
立即学习“PHP免费学习笔记（深入）”；
- 新增包后必须运行：
composer dump-autoload（或简写composer du） - 如果你自己写了类并配置了 PSR-4（如
"App\": "src/"），也要在这步生效；漏掉就会报Class 'AppFoo' not found - 验证是否生效：执行
composer show monolog/monolog，有输出说明已注册；再试php -r "require 'vendor/autoload.php'; var_dump(class_exists('MonologLogger'));"返回 true 才算真正可用 - 常见坑：入口文件里写了
require 'vendor/autoload.php'，但路径不对（比如从子目录访问时相对路径失效），应统一用require __DIR__ . '/vendor/autoload.php';
国内用户卡在下载环节的三个关键点
不是网络差，而是源、权限、扩展三者之一没对上。
- 镜像源必须全局配一次：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，别每个项目都配，也别用过期的腾讯云源（2026 年已停服） - 检查必要 PHP 扩展是否启用：
composer diagnose会明确告诉你缺openssl或zlib—— 这俩缺失会导致连不上任何源 - 私有包装不了？先确认是否混用了私有源配置：
composer show -p列出所有已启用 repo，如果多了一个 internal.company.com，而你想装的是 packagist 上的包，就得临时切回官方源：composer config --unset repos.packagist
最常被忽略的是 autoload 映射没刷新，以及 PHP 版本约束没提前核对 —— 这两个问题不会报“安装失败”，而是安静地让后续代码跑不通。
