用 create-project 初始化才是唯一正解：symfony/skeleton 适合 api/微服务，website-skeleton 开箱即用；目录须不存在，php≥8.1；flex recipe 失效需检查启用状态、allow-contrib、稳定版本及 app_env；生产环境必须 composer install --no-dev --optimize-autoloader；autoload 错误导致命令失效，改完 composer.json 必须 dump-autoload。
别用 composer require symfony/symfony，也别手写 composer.json 再硬装 —— 这样生成的不是可运行项目，而是半截子库，bin/console 会直接报错。
用 create-project 初始化才是唯一正解
Symfony 不是“一个包”，而是一套带目录结构、配置文件和启动入口的项目模板。官方只保证 create-project 生成的结果能跑起来。
-
composer create-project symfony/skeleton my_project：最小骨架，无 Twig、无 Doctrine、无 Web 服务器，适合 API 或微服务 -
composer create-project symfony/website-skeleton my_project：开箱即用，含 Twig、AssetMapper、WebServerBundle 和基础前端构建支持 - 目标目录（如
my_project）必须不存在，否则命令静默失败，不会覆盖 - PHP 版本必须 ≥ 8.1（
symfony/skeleton ^7.0要求），低版本会拉取旧版或卡住
常见报错 Could not find package symfony/skeleton，基本不是包没了，而是 Composer 镜像源滞后或缓存污染。先 composer clear-cache，再临时切回官方源：composer config -g repo.packagist composer https://packagist.org。
require 加包时 Flex recipe 没生效？查这三处
Flex 是 Symfony 的配置中枢，它让 composer require doctrine/doctrine-bundle 自动写 config/packages/doctrine.yaml、建 migrations/ 目录。没生效 ≠ 命令失败，而是 recipe 被跳过或未触发。
- 检查 Flex 是否启用：
composer show symfony/flex，输出应为已安装状态；若为dev-main或高版本（如 2.4.5），基本没问题 - 确认没禁用 recipe：
composer config extra.symfony.allow-contrib返回true才行；误设为false会导致所有自动配置丢失 - recipe 只对稳定版本生效，默认跳过
-dev、-alpha等，加@stable强制走稳定通道：composer require symfony/ux-turbo:^2.0@stable
Flex 生成的配置常带 when@dev 或 when@prod 条件块，务必核对当前 APP_ENV 值是否匹配，否则配置不加载。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
部署时 composer install --no-dev 不能省
把 phpunit/phpunit 或 symfony/debug-bundle 打进生产镜像，不只是浪费磁盘 —— 它可能暴露堆栈、环境变量甚至源码，还可能因 autoload-dev 规则干扰类加载顺序。
-
composer install必须加--no-dev，哪怕COMPOSER_ENV=prod也不顶用 - 推荐完整参数：
composer install --no-interaction --optimize-autoloader --no-dev，其中--optimize-autoloader把 PSR-4 映射转成静态数组，启动快 10%–20% -
composer update是开发期动作，CI/CD 流水线里严禁出现；它会绕过composer.lock，引发版本漂移，导致Class not found或ServiceNotFoundException
本地更新某包时，优先指定范围：composer update symfony/framework-bundle，避免全量刷新导致隐式依赖升级失控。
autoload 配置写错，make:controller 就白忙
Symfony 不靠文件路径找类，全靠 composer.json 里的 autoload 和 autoload-dev 声明。写错映射，php bin/console debug:container 查不到服务，make:controller 生成的类也进不了自动加载器。
- 标准 Symfony 项目
"type": "project"，别手动改成"library"，否则bin/console启动失败 - 确保
autoload包含"psr-4": { "App\": "src/" }，且src/下类命名空间与目录严格对应 - 改完
composer.json后，必须运行composer dump-autoload生效；仅cache:clear不管用
最易被忽略的是：Flex 自动生成的配置（如 bundles.php）和 autoload 规则，都依赖于 composer install 时的脚本执行。如果初始化后漏掉这一步，或者用了 --no-scripts，后续所有命令都会在错误前提下运行。
