5分钟内可在Windows跑通Symfony 8.0：装好PHP 8.0+（官方二进制包+启用mbstring/xml/intl/curl）、Composer 2.5+、Symfony CLI 5.5+，用website-skeleton创建项目并symfony server:start启动，访问127.0.0.1:8000见欢迎页即成功。
在 Windows 上跑通 Symfony 8.0 项目，核心不是装一堆工具，而是用对方法、避开老路径。5 分钟内看到欢迎页是可行的——前提是 PHP、Composer 和 Symfony CLI 都到位，且项目用 完整版模板 启动，不从 skeleton 开始。
装好三样基础工具（Windows 特别注意）
缺一不可，版本必须匹配：
-
PHP 8.0+：推荐使用 windows.php.net 官方二进制包（非 XAMPP/WAMP 内置 PHP），解压后把
php.exe所在目录加入系统环境变量PATH；运行php -v确认输出 ≥ 8.0，并检查php -m | findstr "mbstring xml intl curl"确保扩展已启用（若缺失，在php.ini中取消对应行前的分号） -
Composer 2.5+：下载 Composer-Setup.exe 安装，勾选“Add to PATH”；安装后运行
composer -V验证 -
Symfony CLI 5.5+：以管理员权限打开 PowerShell，执行：
curl -sS https://get.symfony.com/cli/installer | php
再运行：setx PATH "%PATH%;%USERPROFILE%\AppData\Roaming\Composer\vendor\bin"
重启终端后用symfony -V检查
创建并启动第一个可访问项目
别用 symfony/skeleton，它没 Twig、没 WebProfiler、没 MakerBundle，新手会卡在“页面空白”或“找不到模板”：
- 打开命令提示符或 PowerShell，进入你习惯的工作目录（如
D:\projects） - 运行：
composer create-project symfony/website-skeleton myapp - 进入项目：
cd myapp - 启动开发服务器：
symfony server:start - 浏览器访问 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913 —— 看到 Symfony 8 欢迎页即成功
写出第一行动态内容（验证 MVC 流通）
欢迎页是静态的，要确认控制器 → 模板 → 浏览器链路走通，立刻动手：
- 生成控制器：
php bin/console make:controller HomeController - 编辑
src/Controller/HomeController.php，将index()方法改为：return $this->render('home/index.html.twig', ['name' => '王五']); - 在
templates/下新建目录home/，再创建index.html.twig，内容为：<h1>你好，{{ name }}！</h1> - 访问 https://www.php.cn/link/5804a7bec176070ba227bdeaa23c5913/home，显示“你好，王五！”即 MVC 流程已活
调试和排错要点（Windows 常见坑）
出问题时，优先看这三项：
- 确保
.env文件中APP_ENV=dev和APP_DEBUG=1已启用（默认就是，但手动改过可能被覆盖） - 页面右下角出现紫色 Web Debug Toolbar 是关键信号；点开可查路由匹配、Twig 变量、SQL 查询、异常堆栈
- 遇到 500 错误或白屏，先运行：
php bin/console cache:clear
（Windows 下有时因文件权限或缓存锁导致，清缓存几乎解决 80% 初期问题） - 如果
make:controller报错 “Command not found”，说明 MakerBundle 没装全——重新运行composer require --dev symfony/maker-bundle
