Yii视图渲染必须在控制器action中调用$this->render()，严格遵循路径约定（如@/views/控制器ID/视图名.php），布局中固定使用$content变量，且需排查layout末尾的隐式性能瓶颈。
Yii 视图渲染不是“写完 view 文件就能自动显示”，必须走 $this->render() 这条明确路径，且文件位置、参数传递、布局嵌套都容易出错。
render() 调用必须在 controller 的 action 方法内
视图只能由控制器动作触发，不能在 model、widget 或外部 PHP 文件里直接调用 $this->render() —— 因为 $this 此时不是 yii\web\Controller 实例。常见错误是把渲染逻辑写进自定义类或静态方法，结果报 Fatal error: Call to a member function render() on null。
正确做法：
- 确保当前上下文是继承自
yii\web\Controller的控制器类 - 在
actionXXX()方法体内调用$this->render('index', $data) - 若需在外部 action 类中渲染，必须显式传入控制器实例，再调用其
render()，例如：$controller->render('worktime', $data)
view 文件路径和命名必须严格匹配约定
Yii 不会自动搜索或猜测视图位置。$this->render('index') 默认查找的是 @app/views/控制器ID/index.php（如 SiteController → @app/views/site/index.php）。路径错一个字母、大小写不一致、后缀漏掉 .php，都会导致 Invalid Route 或白屏无报错（尤其在生产环境关闭调试时）。
关键点：
- 控制器 ID 是类名去掉
Controller后缀并转为小写连字符形式（UserProfileController→user-profile） - 视图文件必须是
.php后缀，不能是.html或.twig（除非额外配置 view renderer） - 想用绝对路径？可以，但要加
@别名，例如：$this->render('@app/views/common/header', $data)
layout 嵌套时，$content 变量名不能改
当你在视图里用 $this->beginContent('@app/views/layouts/main.php') 或直接设置 $this->layout = 'main'，Yii 会把当前视图渲染结果赋给 $content 变量，再 require layout 文件。如果 layout 里写的是 echo $body 或 print $pageContent，页面就空白——因为 Yii 只注入 $content。
典型 layout 主干结构应为：
<header>...</header><main>= $content ?></main><footer>...</footer>
注意：$content 是硬编码变量名，不可替换；也不建议在 layout 中再次调用 render()，否则可能触发递归或作用域丢失。
性能卡在 render() 后？检查 layout 末尾和 response 发送时机
有用户发现 $this->render('index') 执行很快，但整个页面加载要 4–5 秒——问题往往不在视图本身，而在 layout 渲染完成后的后续流程：比如未关闭的数据库连接、未释放的大数组、或 layout 末尾意外调用了耗时函数（如 file_get_contents() 加载远程资源）。
排查建议：
- 在 layout 文件最末尾加
die('layout end');，看是否卡住——如果是，问题就在 layout 后半段 - 禁用所有 layout：
$this->layout = false;，对比响应时间 - 确认没在视图或 layout 中使用
sleep()、usleep()或阻塞式 I/O
真正难调试的，是那些不报错、不抛异常、只拖慢响应的 side effect —— 它们藏在 layout 的 HTML 注释之后、PHP 关闭标签之前，或者被 ob_start() 缓冲掩盖了。
