最稳妥方式是用 composer create-project symfony/skeleton 创建项目，它自动拉取版本对齐的骨架并完成依赖安装；手动 require 或全局安装已弃用，且需确保 composer ≥ 2.2、php ≥ 8.1。
直接用 composer create-project 创建 Symfony 项目最稳妥
别手动 require symfony/symfony 或抄旧教程的全局安装方式——Symfony 官方早已弃用全局 symfony 命令（v5.4+），且不推荐用 composer global require 装框架本身。正确路径是：用 composer create-project 一次性拉取完整、版本对齐的项目骨架。
执行前确保：composer 已安装且版本 ≥ 2.2，PHP ≥ 8.1（Symfony 6.4+ 要求）。
运行命令：
composer create-project symfony/skeleton my_project
它会自动选最新稳定版（如 6.4.x），并生成最小可用结构。若需指定版本，加 --stability=stable 或写明版本号：
composer create-project symfony/skeleton:^7.0 my_project
- 不用
symfony/cli启动开发服务器（v6.2+ 已移除内置 server:start） -
symfony/skeleton不含 Webpack Encore、Doctrine 等，默认轻量；要加组件，后续用composer require单独装 - 避免用
composer create-project symfony/framework-bundle—— 这只是个 Bundle，不是可运行项目
启动本地开发服务器必须用 php -S 或反向代理
Symfony 不再自带 PHP 内置服务器命令。官方推荐用 php -S 配合 public/index.php 启动，这是最简单、零依赖的方式。
进入项目目录后运行：
cd my_project && php -S localhost:8000 -t public
浏览器打开 http://localhost:8000 即可看到欢迎页。注意：
工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。
-
-t public是必须的，否则路由无法匹配到前端控制器 - 别用
php bin/console server:start—— 该命令在 Symfony 4.0 就已废弃，v5+ 完全删除 - 如果提示
Failed to open stream: No such file or directory，检查是否漏了-t public或当前路径不对 - Windows 用户若遇端口占用，换端口即可：
php -S localhost:8080 -t public
composer require 加功能时得看清包名和隐式依赖
比如想加数据库支持，不能只装 doctrine/orm。Symfony 的 Doctrine 集成靠 symfony/orm-pack（v5.4+）或更细粒度的 doctrine/doctrine-bundle（v6+ 推荐）。
正确做法：
composer require doctrine/doctrine-bundle
它会自动拉取 doctrine/orm、doctrine/dbal 及适配器，并注册 Bundle。其他常见组合：
- Web 开发：
composer require twig/twig symfony/webpack-encore-bundle - API 开发：
composer require api-platform/api-pack（含 API Platform + Doctrine + Swagger） - 表单：
composer require symfony/form（同时需symfony/validator和twig/twig） - 别直接
composer require symfony/framework-bundle—— 它已在 skeleton 中预装，重复 require 会冲突
环境变量和缓存问题常导致“白屏但无报错”
首次访问 http://localhost:8000 出现空白页，大概率不是代码错，而是环境或缓存卡住。
先检查三件事：
- 确认
.env文件存在且APP_ENV=dev，否则错误被静默吞掉 - 清空缓存：
php bin/console cache:clear --env=dev（即使没改代码，首次运行也建议清） - 查看
var/log/dev.log，真实错误（如扩展缺失、权限不足）都记在这里，比浏览器看到的多得多 - PHP 缺扩展？运行
php -m | grep -E 'pdo|curl|mbstring|xml'，Symfony dev 模式至少需要这些
一个典型坑：Mac M1/M2 上用 Homebrew 装的 PHP 默认没开 opcache，而 Symfony dev 模式依赖它加速类加载——php -v 若显示 with Zend OPcache v8.x 才算启用。
