必须先掌握src/、config/、public/、templates/四大核心目录职责：src/对应App\命名空间且需PSR-4严格对齐；config/含bundles.php和服务/路由配置，加载顺序影响运行；public/是Web服务器唯一入口，index.php为统一前端控制器；templates/存放Twig模板，路径名直接映射引用名。
要快速理解一个刚接手的Symfony项目是怎么组织的，必须先搞清楚每个顶层目录的职责边界——src/不是放所有代码的地方，public/也不是只放图片，弄错一个目录就可能让路由失效或模板找不到。
识别项目根目录下的四大核心目录
打开终端进入项目根目录后，执行 ls -F，你会看到至少这四个带斜杠的目录：src/、config/、public/、templates/。它们不是随意命名的，而是由Symfony官方约定且被自动加载机制硬编码识别的。
src/ 是唯一被自动注册为PSR-4命名空间的目录，默认映射到 App\ 根命名空间；其他目录若擅自改名，会导致控制器类无法自动加载、服务定义失效、Twig模板报错“Template not found”。
config/ 下的 YAML 文件（如 services.yaml、routes.yaml）会被容器启动时逐个解析，顺序不可颠倒——packages/ 子目录优先于根级配置，而 services.yaml 必须存在，否则服务容器初始化失败。
public/ 目录：Web服务器唯一可见的入口点
Apache 或 Nginx 的 document root 必须指向 public/ 目录，而不是项目根目录。这是强制要求，不是建议。
public/index.php 是整个应用的单一入口文件，它引导请求进入 Symfony 内核；public/assets/（如果存在）是 Webpack Encore 构建后的静态资源输出目录，但该目录本身不参与 PHP 自动加载流程。
【不要把 .env 文件放在 public/ 下】，否则可能被直接 HTTP 访问导致密钥泄露。.env 必须位于项目根目录，且被 Web 服务器明确禁止访问。
templates/：Twig 模板的法定归属地
所有 Twig 模板文件（.html.twig）必须放在 templates/ 下，子目录结构会直接映射为模板路径名。例如 templates/admin/dashboard.html.twig 对应的模板引用名就是 admin/dashboard.html.twig。
templates/base.html.twig 是最常被继承的母版，但它不是强制存在的——如果控制器中 render() 引用了一个不存在的模板，错误发生在运行时，不会在 composer install 阶段报错。
templates/ 下可以有任意嵌套层级，但不要在其中放 PHP 文件或配置文件，Twig 加载器默认只扫描 .twig 后缀。
config/ 目录：配置分层与加载顺序
第一步：查看 config/bundles.php，它声明当前启用哪些 Bundle，每一行都是一个类名 → 是否启用的布尔值映射。
第二步：打开 config/packages/，里面每个 YAML 文件对应一个功能模块的配置，比如 doctrine.yaml 控制数据库连接，framework.yaml 控制 Session、Translation、Validation 等核心功能开关。
第三步：检查 config/routes/，这里存放按功能拆分的路由配置文件（如 annotations.yaml、messenger.yaml），它们通过 imports: 在 config/routes.yaml 中被统一引入。
注意：config/services.yaml 是服务容器的主配置文件，修改后必须清除缓存（php bin/console cache:clear），否则新定义的服务不会生效。
