必须用composer create-project初始化项目，因手动建项目会漏掉Flex自动配置，导致config/packages无默认配置、src/Controller/不自动生成，且Flex是Symfony 5.4+配置中枢，禁用将引发组件配置错配与路径错误。
直接用 composer create-project 创建即可，别从空文件夹 + 手动装包起步——那样大概率会漏掉 Symfony Flex 的自动配置能力，后续要反复修 config/ 和 src/ 结构。
用 Composer 创建带 Flex 的标准项目
Symfony 官方推荐且唯一能开箱获得合理目录结构、自动包配置和 recipe 支持的方式，就是通过 Composer 调用官方模板：
- 运行
composer create-project symfony/skeleton my_project（轻量骨架）或composer create-project symfony/website-skeleton my_project（含 Webpack Encore、Twig、Doctrine 等常用组件） - 不要用
mkdir + composer init + composer require symfony/framework-bundle—— 这样不会触发 Flex 的 recipe 机制，config/packages/下没默认配置，src/Controller/也不会自动生成 - 创建后立刻进目录跑
php bin/console about，确认输出里有Flex: enabled
为什么不能跳过 Flex 或手动配 bundle
Flex 不是可选插件，它是 Symfony 5.4+ 的配置中枢。没有它，你遇到的问题不是“少写几行配置”，而是：
-
composer require doctrine/doctrine-bundle后，config/packages/doctrine.yaml不会自动生成，得自己照文档手写，稍有参数错位（比如把doctrine.dbal.url写成doctrine.dbal.dsn）就会报The child node "url" at path "doctrine.dbal" does not exist -
composer require twig/twig-bundle后，templates/目录不创建，src/Controller/DefaultController.php不生成，连第一个return $this->render('base.html.twig');都会因路径不存在而报错 - Flex 还负责管理
symfony.lock，控制 recipe 版本兼容性；手动安装容易让 Doctrine、Messenger、Mailer 等组件的配置版本错配
第一次启动前必须检查的三件事
项目创建完别急着 php -S，先确认基础链路通：
- 环境变量：确保
.env中APP_ENV=dev且APP_DEBUG=1，否则错误页面不显示堆栈，只看到空白 500 - Web 服务器：用
php -S 127.0.0.1:8000 -t public启动（不是public/index.php），因为public/index.php是入口，但 PHP 内置服务器需指定-t public才能正确路由 - 缓存权限：首次访问前运行
php bin/console cache:clear，否则var/cache/dev/目录可能因权限问题无法写入，导致Unable to write in the "/var/cache/dev" directory
Flex 的 recipe 注入逻辑藏在 composer.json 的 extra.symfony.id 和 scripts 里，删了或改错一个字段，后续 composer require 就不再生效——这种问题往往要翻 vendor/symfony/flex/src/Unpacker.php 才能看出端倪。
