刚装好 Symfony 7.4 无法访问欢迎页或控制器不生效，根本原因是模板选错、服务器启动路径错误、缓存未清、环境未切至 dev；须用 website-skeleton 模板、执行 php -S localhost:8000 -t public、运行 cache:clear 并确认 .env 中 APP_ENV=dev 和 APP_DEBUG=1。
刚装好 Symfony 7.4，却卡在“访问不了欢迎页”或“控制器不生效”？别急，问题往往出在几个关键动作没做对——项目模板选错、服务启动路径不对、缓存没清、环境没切对。按下面几步走，10 分钟内让页面跑起来。
用对模板：别碰 skeleton，直接上 website-skeleton
Symfony 7.4 的 skeleton 极简，缺 Twig、WebProfiler、MakerBundle，新手根本跑不起来。必须用带完整 Web 堆栈的模板：
- 运行：composer create-project symfony/website-skeleton myapp
- 进目录后立刻验证 Flex 是否就位：php bin/console about → 看到 Flex: enabled 才算成功
- 如果输出里没有 Flex 或报错，说明安装失败，删掉 myapp 重来
正确启动内置服务器
很多人输 php -S localhost:8000 却打不开页面，是因为没指定文档根目录：
- 正确命令：php -S localhost:8000 -t public（注意 -t public，不是
index.php） - 浏览器访问：https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774，看到 Symfony 欢迎页才算服务真正启动
- 如果页面空白或报 404，请检查当前目录是否为
myapp/，且public/下有index.php
写完控制器，记得清缓存再访问
生成控制器（如 make:controller HomeController）并改完模板后，仍看不到变化？大概率是开发缓存没刷新：
- 每次修改 PHP 或 Twig 后首次访问前，先执行：php bin/console cache:clear
- 尤其在 Linux/macOS 上，若提示权限错误或 500，90% 是缓存目录不可写，
cache:clear能重建并修复权限 - 确认
.env中已设为开发环境：APP_ENV=dev 且 APP_DEBUG=1
调试栏和错误信息是你的第一线索
右下角紫色调试栏（Web Profiler）不是装饰，而是排错核心工具：
- 没出现？检查
.env是否满足APP_ENV=dev+APP_DEBUG=1，且路由访问的是/或/home这类非生产路由 - 点击调试栏可查看请求、日志、数据库查询、Twig 变量等，比如模板中
{{ name }}渲染失败，直接看 “Twig” 标签页就能定位变量是否传入 - 遇到白屏或 500，先看浏览器 Network 面板的响应内容，通常会直接打印出异常堆栈
