控制器中通过设置 $this->layout 属性指定 layout：赋值字符串（如 'admin'）加载对应文件，false 禁用 layout，null 回退默认；路径须用别名或完整路径，不带 .php 扩展名。
控制器里怎么指定 layout 文件
Yii 2.0 中，控制器默认使用 @app/views/layouts/main.php，但你可以在控制器里直接覆盖它。关键不是改配置，而是改属性。
-
$this->layout是控制器实例的公开属性，赋值字符串即可切换 layout，比如$this->layout = 'admin'会去找@app/views/layouts/admin.php - 设为
false表示禁用 layout，只渲染视图内容本身（适合 AJAX 返回、弹窗片段） - 设为
null表示沿用父类或应用级默认（不常用，容易误以为“清空”，其实只是回退） - 路径不支持别名缩写以外的写法，比如不能写
../layouts/custom，必须用别名或完整路径（如@app/views/layouts/custom.php）
全局 layout 配置在哪改
应用级统一 layout 在 config/web.php 的 components['view'] 配置里，不是在 controllerMap 或 modules 里。
- 修改
'view' => ['class' => 'yii\web\View', 'layout' => 'main']中的layout值，影响所有未显式覆盖的控制器 - 如果项目有前后台分离，常见做法是：后台控制器继承自
AdminController，并在其init()里统一设$this->layout = 'admin'，比全局配更灵活 - 注意：
layout值不带扩展名，框架自动加.php；写成'main.php'会导致找不到文件（错误信息：Layout file does not exist）
模块（Module）里 layout 怎么隔离
模块有自己的视图路径和 layout 查找逻辑，但不会自动隔离 layout，得手动干预。
- 在模块类的
init()方法里设置$this->layout = 'module-layout'，这样该模块下所有控制器默认用这个 layout（前提是没在控制器里再覆盖） - 模块 layout 默认仍从
@app/views/layouts/下找，若想用模块私有 layout，需同时配置View组件的theme或重写getViewPath()，但多数情况没必要——直接把 layout 放到@app/views/layouts/下加前缀更省事（如admin-main.php） - 模块中控制器若设了
$this->layout = '@app/modules/admin/views/layouts/base'，要注意路径别名必须已注册，否则报错：Invalid path alias
常见 layout 加载失败错误和排查点
layout 找不到时，Yii 不会静默降级，而是抛出异常，但错误提示容易误导人。
-
Layout file does not exist: /path/to/xxx.php—— 先确认文件是否存在，再检查是否拼错名字（比如写了main2.php却配成'main2'是对的，但配成'main2.php'就错） - 页面空白但无报错？可能是 layout 文件里语法错误（如漏掉
?>），PHP 解析失败导致白屏，打开error_reporting和display_errors才能看到 - 部分页面 layout 生效、部分不生效？检查是否在某个控制器方法里（比如
actionIndex()）里写了$this->layout = null或提前 return，导致后续逻辑没执行到 layout 设置 - 用 Gii 生成的控制器默认带
$this->layout = false，新建控制器后忘了删，就会发现页面没外层结构——这是新人最常踩的坑
layout 的查找顺序和路径解析看似简单，但 Yii 2.0 对别名、扩展名、null/false 的处理边界很细，动一个地方最好连着 View::getLayoutFile() 的源码逻辑一起看一眼。
