正确安装命令是 composer require doctrine/orm:^3.0（PHP 8.1+），否则需用 ^2.15；必须同时安装 doctrine/persistence 和 doctrine/annotations，且配置 EntityManager 时确保注解路径、命名空间和 @Entity 注解三者匹配。
Composer 安装 Doctrine ORM 时 composer require 报错找不到包
Doctrine ORM 的官方包名是 doctrine/orm，不是 doctrine-orm 或 doctrine/DoctrineORM。很多人输错名字导致 Composer 提示 “Package not found” 或 “Could not find package”。
正确命令只有一行，且必须指定 PHP 版本兼容性（Doctrine 3+ 要求 PHP 8.1+）：
composer require doctrine/orm:^3.0
- 不加
^3.0可能默认拉取 v2.x（已 EOL），尤其在旧项目里容易踩坑 - 如果项目 PHP 是 8.0 或更低，得用
doctrine/orm:^2.15，但注意 v2 已停止维护，安全补丁不再发布 - 执行前确认
composer.json中"config": {"platform": {"php": "8.1.0"}}设置匹配，否则 Composer 可能跳过高版本依赖
安装后 EntityManager 初始化失败：Missing doctrine/common 或 doctrine/persistence
Doctrine ORM v3 不再内置 persistence 层，所有映射、仓库、管理器都依赖 doctrine/persistence 和 doctrine/common（仅部分工具类）。Composer 安装 doctrine/orm 会自动拉取它们，但如果你手动删过 vendor 或用 --no-install，就会缺。
验证是否完整安装：
composer show doctrine/persistence doctrine/common
- 如果任一命令报 “No package found”，说明依赖链断裂，直接运行
composer install或composer update doctrine/orm - 别手动
requiredoctrine/common—— 它在 v3 中只是辅助包，主逻辑全在doctrine/persistence里 -
EntityManager::create()报 “Class not found” 通常就是doctrine/persistence没加载，检查vendor/autoload.php是否被正确引入
配置 doctrine/orm 时 SimpleAnnotationReader 不工作
Doctrine 默认用 AnnotationReader 解析 PHPDoc 注解（比如 @Entity），但如果你没装 doctrine/annotations，或用了 SimpleAnnotationReader（不支持缓存、不识别 @Table 等高级注解），实体扫描就会静默失败。
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
最小可用注解支持组合：
composer require doctrine/annotations:^2.0
-
doctrine/annotations是硬依赖，不是可选 —— 即使你用 XML/YAML 映射，命令行工具（如doctrine:schema:create）仍需它来读取实体元数据 - 别在代码里 new
SimpleAnnotationReader；应使用AnnotationReader+AnnotationRegistry::registerLoader加载类 - PHP 8.0+ 用户注意：
doctrine/annotationsv2 支持 PHP 8 attributes，但需显式启用：传['ignore_annotations' => false]给AnnotationReader构造函数
运行 doctrine:schema:update 提示 “No mapping file found”
这是 Doctrine 找不到实体类的最常见表现，和 Composer 安装无关，但新手常以为是装错了。根本原因是 EntityManager 配置里 mappings 路径没对上，或实体没加 @Entity 注解 / 没注册到 YAML/PHP 映射文件。
快速定位步骤：
- 检查
EntityManager构建时传入的$config->setMetadataDriverImpl(...)是否指向正确的路径，例如new AnnotationDriver(new AnnotationReader(), [__DIR__.'/src/Entity']) - 确认实体类文件在该路径下，且命名空间与目录结构一致（如
App\Entity\User必须在src/Entity/User.php） - 运行
php vendor/bin/doctrine orm:validate-schema—— 它会明确告诉你哪个类没被识别、为什么（比如 missing @Entity，或 use 语句漏了use Doctrine\ORM\Mapping as ORM;）
Doctrine ORM 的“安装完成”不等于“能用”，实体发现机制是独立于 Composer 的运行时行为，路径、命名空间、注解三者差一个就白装。
