必须将require __dir__ . '/vendor/autoload.php';放在入口文件第一行，因php自动加载需在首次类引用前注册，否则触发fatal error；路径用__dir__确保跨环境可靠。
能跑通 composer require 和正确引入 vendor/autoload.php，你就已经掌握 Composer 的核心了——它不是一门要“学”的技术，而是一个只要用对三处关键位置就能立刻生效的工具。
怎么验证 composer 命令真能用，不是假成功？
很多人敲完 composer --version 看到数字就以为装好了，结果一跑 composer install 就卡在 Downloading https://packagist.org/packages.json。这不是命令没装，是网络或配置没通。
- 第一步必须跑
composer diagnose：它会检查 DNS、HTTPS 证书、CA 路径、写权限，比单纯看版本号靠谱得多 - 如果卡在下载
packages.json，别折腾代理，直接换国内镜像：composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - Windows 用户在 WSL 里千万别在
/mnt/c/下执行命令——IO 性能差，composer install极易假死或报错failed to extract - 报
command not found？说明 PATH 没配对，不是 Composer 坏了；临时救急用php composer.phar --version测试，确认是路径问题再修环境
为什么 vendor/autoload.php 必须放在入口文件第一行？
PHP 的自动加载是“一次性注册”机制。一旦某个类名被首次引用时还没定义，就会触发 fatal error，后面再 require 什么都救不回来。
Workflow Decomposer
下载
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
- 错误写法：
session_start(); echo 'hello'; require 'vendor/autoload.php'; new Monolog\Logger('app');→ 报Cannot send session cache limiter或Class 'Monolog\Logger' not found - 正确写法：第一行且唯一一行就是
require __DIR__ . '/vendor/autoload.php';，__DIR__保证路径绝对可靠，./vendor/autoload.php在 CLI 和 Web 下行为不一致，上线必挂 - 老项目没命名空间？别硬套 PSR-4。改用
"classmap": ["lib/", "includes/"]，然后跑一次composer dump-autoload，比重构代码快得多
composer install 和 composer update 到底该用哪个？
这不是习惯问题，是环境一致性红线。用错一个，线上可能直接 500。
- 刚 clone 项目、CI 构建、部署上线 → 只能用
composer install：它读composer.lock，装的版本和提交时完全一致 - 本地开发想加个新包（比如
monolog/monolog）→ 用composer require monolog/monolog，它内部自动update并更新lock文件 - 只想升小版本（如
2.1.3 → 2.1.9）→ 用composer update --with-dependencies；裸跑composer update会重算整个依赖树，可能意外升级大版本导致兼容问题
新手最常踩的坑：从 composer init 开始就错了
composer init 只生成空壳 composer.json，没代码、没目录结构、没测试、不初始化 Git，新手常卡在“接下来干啥”。真实项目几乎都不这么起手。
- 推荐用
composer create-project：比如composer create-project laravel/laravel my-app，直接拉完整骨架，含路由、命令行、测试、自动加载配置 - 轻量项目可用
php-http/skeleton或静默创建 Symfony：composer create-project --no-interaction symfony/skeleton my-symfony -
create-project默认拉 stable 版本（如v6.4.0），想试开发版得显式加dev-main或--stability=dev
复杂点在于：Composer 本身不难，难的是它把“依赖版本锁定”“自动加载时机”“路径可靠性”这些隐性约束全打包进一条命令里。最容易被忽略的，永远是那行 require __DIR__ . '/vendor/autoload.php'; —— 它不在文档最前面，但一旦漏掉或放错位置，所有后续工作都白搭。
