Yii 3.0 中需显式声明渲染路径并手动组装布局：布局文件置于 resources/views/layouts/main.php，须含 strict_types 声明，用 <?= $content ?> 插入内容，<?= $head ?? '' ?> 和 <?= $scripts ?? '' ?> 分别注入头和脚本；AssetBundle 必须注册并启用 AssetMiddleware；渲染时指定完整布局路径如 'layouts/main'。
要在 Yii 3.0 中正确渲染视图并让前端资源（CSS/JS）可靠加载，必须绕过 Yii 2.x 的 $this->render() 和 layout 自动注入机制——因为控制器不再继承基类，$this->layout、$content 等变量彻底消失，所有渲染路径需显式声明、手动组装。
定义基础布局文件
在项目根目录下创建 resources/views/layouts/main.php，注意不是 views/layouts/（Yii 3.0 默认不扫描该路径）。这个文件必须是纯 PHP 模板，不能依赖任何框架辅助函数。
开头写 <?php declare(strict_types=1); ?> ——这是硬性前提，缺了会导致整个模板解析失败。
用 <?= $content ?> 插入视图内容，不要用 echo $content 或其他变体，【$content 是由 ApplicationFactory 注入的字符串，不可修改或过滤】。
立即学习“前端免费学习笔记（深入）”；
在 <head> 中调用 <?= $head ?? '' ?>，在 </body> 前插入 <?= $scripts ?? '' ?> ——这两个变量由 AssetMiddleware 自动注入，缺失会导致 CSS/JS 不加载。
注册并启用 AssetBundle
新建 src/Asset/AppAsset.php，继承 yiisoft/asset/AssetBundle，定义 public $basePath = '@public'; 和 public $baseUrl = '/';。
在 $css 数组中写入 'css/site.css'，路径必须相对于 public 目录，不能带前导斜杠；【若写成 '/css/site.css'，浏览器会请求根路径而非 public 下资源】。
在 config/common.php 中注册该包：AppAsset::class => ['class' => AppAsset::class] ——这步不可跳过，否则 AssetMiddleware 找不到包定义。
PigX UI Pro 前端开发指南 - Vue 3 + TypeScript + Element Plus。当用户提到 PigX UI、PigX 前端、lgb-mgui 项目、Vue 3 企业级后台开发、Element Plus 后台开发时使用此技能。
在路由中间件链中插入 yiisoft/asset/AssetMiddleware::class，位置必须在响应生成之前，通常放在最后几个中间件里。
在控制器中渲染视图
第一步：在 action 方法中获取视图渲染器实例：$renderer = $this->container->get(ViewRendererInterface::class);
第二步：准备数据数组，例如 $data = ['title' => 'Dashboard', 'items' => $this->service->getRecent()];
第三步：调用渲染：return $renderer->render('dashboard/index', $data, 'layouts/main'); ——第三个参数是布局模板路径，必须与 resources/views/ 下的相对路径一致，不带扩展名。
注意：如果传入 'main' 而非 'layouts/main'，渲染器会去查 resources/views/main.php，而不是你定义的布局文件。
前端静态资源路径处理
方法一：在 AppAsset 中使用 public $publishOptions = ['only' => ['css/', 'js/']] 控制发布范围，避免把 .php 或测试文件误推到 public。
方法二：直接在 layout 中用 <link rel="stylesheet" href="/css/site.css"> 硬编码路径——仅限开发调试，生产环境必须走 AssetBundle，否则无法启用版本哈希和 CDN 替换。
方法三：在视图中调用 <?= $this->assetManager->getPublishedUrl('css/app.css') ?> 获取带时间戳或哈希的 URL，但前提是 $this->assetManager 已通过构造函数注入到当前视图上下文——Yii 3.0 不提供全局 $this 引用，未注入则报错。
