Symfony安装关键是选对方式、避开常见坑，推荐新手用composer create-project symfony/skeleton my_project一键创建最小化项目，PHP 8.0+和Composer就绪后，5分钟内即可通过php -S localhost:8000 -t public启动并访问欢迎页。
Symfony 安装其实不难，关键是选对方式、避开常见坑。新手常被“官方文档太长”“依赖报错”“PHP版本不匹配”劝退，其实只要按步骤来，5分钟就能跑起第一个 Symfony 应用。
用 Composer 一键创建项目（推荐新手）
这是最简单、最可控的方式，不需要手动下载、解压或配置全局环境。
- 确保已安装 PHP（8.0+）和 Composer（运行 composer --version 验证）
- 在终端执行命令：
composer create-project symfony/skeleton my_project - 进入项目目录：cd my_project
- 启动内置服务器：php -S localhost:8000 -t public
- 浏览器打开 http://localhost:8000，看到 Symfony 的欢迎页就成功了
别急着装 Webpack Encore 或 Doctrine（初学阶段可跳过）
刚入门时，先专注理解路由、控制器、模板这三块核心。官方 skeleton 默认是“最小化安装”，没有数据库、前端构建工具等额外组件——这反而是优势。
- 想加数据库？等学到 Doctrine 章节再用 composer require doctrine
- 想处理 CSS/JS？等需要前端集成时再装 composer require symfony/webpack-encore-bundle
- 强行一步到位，反而容易因 Node.js 版本、Yarn 权限等问题卡住
常见报错快速自查清单
遇到问题别慌，90% 出在环境或拼写上：
- "Command 'composer' not found" → 重新安装 Composer，并确认它在系统 PATH 中
- "PHP version too low" → 运行 php -v 查看版本，Symfony 6+ 要求 PHP 8.0+
- 白屏或 500 错误 → 检查 var/log/dev.log，通常会提示具体哪行代码出错
- 访问 localhost:8000 显示 “No input file specified” → 确保你在项目根目录运行 php -S 命令，且 -t 参数指向 public 目录
下一步：写你的第一个控制器
安装完只是起点。马上动手改代码，才能真正记住流程：
- 在 src/Controller/ 下新建 HomeController.php
- 写一个返回 “Hello, Symfony!” 的方法，并用 #[Route('/hello')] 注解绑定路径
- 清除缓存：php bin/console cache:clear（开发环境可加 --env=dev）
- 访问 http://localhost:8000/hello，看到文字就说明你已掌握 Symfony 的请求响应闭环
