Yii视图文件默认放在@app/views/下，按控制器名分目录，如SiteController对应@app/views/site/；路径由viewPath属性决定，跨目录需用完整路径别名或修改viewPath。
视图文件默认放在哪里？
Yii 默认把视图文件放在 @app/views/ 下，按控制器名分目录。比如 SiteController 的视图，就放 @app/views/site/ 里；UserController 对应 @app/views/user/。这个路径不是硬编码的，而是由控制器的 viewPath 属性决定，默认值就是那个规则。
常见错误现象：Invalid Parameter – yii\base\InvalidParamException 提示“View file does not exist”，八成是路径没对上——比如在 site/index 里写了 $this->render('user/profile')，但实际文件在 @app/views/user/profile.php，而当前控制器是 SiteController，它默认只查 @app/views/site/，不会自动跳到别的目录。
- 想跨目录渲染，必须写完整路径别名，比如
$this->render('@app/views/user/profile') - 也可以临时改
viewPath：$this->viewPath = '@app/views/user'; $this->render('profile'); - 不推荐用相对路径（如
../user/profile），Yii 不解析这种写法，会直接拼到当前viewPath后面，结果多半是错的
多个模块下视图怎么找？
有模块（Module）时，Yii 会先查模块自己的 views 目录，再 fallback 到应用级 @app/views/。比如 admin 模块的 PostController 调用 $this->render('edit')，查找顺序是：
@app/modules/admin/views/post/edit.php-
@app/views/post/edit.php（仅当模块没设viewPath或该文件不存在时）
注意：模块的 viewPath 默认是 @app/modules/<module_id>/views</module_id>，但如果你在模块类里显式设置了 public $viewPath = '@app/views'，那它就完全绕过模块视图目录了——这容易导致本地开发看着正常，上线后因模块视图被覆盖而出问题。
render() 和 renderPartial() 查找逻辑一样吗？
一样。两者都走同一套视图定位逻辑，区别只在是否渲染布局（layout）和是否触发 beginPage/endPage 等生命周期事件。renderPartial() 不加载 layout，也不处理 AssetBundle 注册，适合 AJAX 返回片段。
容易踩的坑：
- 误以为
renderPartial()能“绕过”视图路径限制——其实它照样要找edit.php，路径错了一样报View file does not exist - 在
renderPartial()里用了$this->registerJs()，但 JS 没执行——因为 partial 不触发 asset 发布流程，得手动调yii\web\View::registerJsFile()或确保 asset bundle 已提前注册 - 传参方式没区别：
render('index', ['model' => $model])和renderPartial('index', [...])参数结构完全一致
自定义视图路径或添加搜索位置？
可以，通过重写控制器的 getViewPath() 方法，或者在应用配置里全局改 'view' => ['class' => 'yii\web\View', 'theme' => [...]]。但更常用、也更轻量的是用 yii\base\View::addWidgetPath() 或直接操作 View 实例的 $theme->basePath ——不过这些属于进阶定制，90% 的项目根本不需要动。
真正值得留意的其实是主题（Theme）机制：如果启用了主题，Yii 会先查主题路径（如 @app/themes/basic/views/site/index.php），再查默认路径。启用方式是配置 'view' => ['theme' => ['pathMap' => [...], 'baseUrl' => ...]]。这里最容易忽略的是 pathMap 的键必须带尾部斜杠，比如 '@app/views/' => '@app/themes/basic/views/'，少那个 / 就匹配失败。
复杂点在于，主题路径匹配是前缀式替换，不是文件存在性检查——它不管目标文件是否存在，直接拼完就去读，所以错误提示还是 “View file does not exist”，但你可能在查错时漏掉主题层的路径干扰。
