正确安装 Symfony Bundle 需三步：先 composer require vendor/bundle-name 下载，再在 config/bundles.php 中启用，最后运行 bin/console cache:clear 刷新缓存；缺一不可。

怎么用 composer require 正确安装一个 Symfony Bundle

Bundle 不是独立运行的程序，它必须被 Symfony 内核识别、加载并注册服务。所以不能只靠 composer require 就完事——漏掉启用步骤，90% 的情况会直接报 Class not found 或路由/服务不可用。

• 先执行 composer require vendor/bundle-name（例如 composer require cron/symfony-bundle），它会下载代码、写入 composer.json、更新 vendor/ 和自动加载映射
• 接着手动打开 config/bundles.php，添加一行启用声明：例如 CronSymfonyBundleCronSymfonyBundle::class => ['all' => true]
• 如果 Bundle 提供了配置文件（如 config/packages/cron.yaml），它通常由 Symfony Flex 自动注入；但若项目没装 Flex 或用了 symfony/skeleton，就得自己建并填内容
• 别跳过 bin/console cache:clear —— 启用新 Bundle 后不清缓存，内核可能仍按旧配置启动，导致行为不一致

为什么 composer require --dev 装的 Bundle 在生产环境会失效

因为 --dev 会把包写进 composer.json 的 require-dev 字段，而部署时通常运行 composer install --no-dev，这些 Bundle 根本不会被装进 vendor/，更别说加载了。

Workflow Decomposer

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

下载

• 典型踩坑场景：本地用 nyholm/symfony-bundle-test 写 Bundle 测试，却误加在 require 下；或反过来，把 symfony/web-profiler-bundle 加进 require-dev 后，发现开发环境都打不开 profiler
• 判断依据很简单：看 composer.json 里这个 Bundle 是在 require 还是 require-dev 区块
• 线上环境绝对不要依赖 require-dev 里的 Bundle；哪怕只是提供命令行工具（如 doctrine/doctrine-bundle 的迁移命令），只要运行时需要，就必须进 require

composer dump-autoload 什么时候必须跑，什么时候纯属白忙

它只刷新 PHP 的类自动加载映射，和 Bundle 是否启用、配置是否生效完全无关。很多人一报错就下意识敲这句，结果毫无作用。

• 必须跑的情况：src/ 下新增了类但 composer.json 的 autoload 配置没覆盖到路径，或改了命名空间但没同步更新 psr-4 映射
• 完全没必要的情况：刚 require 了一个 Bundle、修改了 bundles.php、调整了 config/packages/xxx.yaml —— 这些都不动类文件结构，dump-autoload 不解决任何问题
• 真正该做的是：bin/console debug:container 查服务是否存在，bin/console debug:router 看路由有没有注册，而不是反复重刷 autoload

自定义 Bundle 放 vendor/ 外面怎么让 Composer 认得

Composer 默认只管 vendor/，你把 Bundle 拷到项目根目录下的 bundles/my-bundle，它压根不会扫描——除非你主动告诉它。

• 在项目根目录的 composer.json 里加一段本地路径仓库：

  "repositories": [
    {
      "type": "path",
      "url": "./bundles/my-bundle"
    }
  ]

• 然后运行 composer require my-vendor/my-bundle:dev-main（注意版本号要匹配你 bundles/my-bundle/composer.json 里的 version 或分支名）
• 关键点：这个本地 Bundle 的 composer.json 必须有合法 autoload 配置（比如 "psr-4": {"MyVendor\MyBundle\": "src/"}），否则即使装进来了，类也找不到
• 别指望 autoload-files 或硬 require 来绕过——Bundle 的服务定义、配置加载、事件订阅全依赖标准流程，手动拼凑大概率启动失败

Bundle 的“安装”本质是三步闭环：Composer 下载 → bundles.php 启用 → 内核加载并注册。少一步，它就只是硬盘上的一堆 PHP 文件。