在Yii2.0.55中启用自定义主题需三步：一是在config/web.php配置view组件的theme路径映射；二是确保@app/themes/mytheme目录结构完整（含views/layouts等）；三是清空runtime缓存。主题布局须置于@app/themes/mytheme/views/layouts/，小部件可替换视图或扩展类，静态资源通过自定义AssetBundle注入并确保Web可访问。
在Yii2.0.55项目中启用自定义主题模板，核心是让视图渲染时自动从主题目录（如@app/themes/mytheme）加载布局、小部件和页面视图，而非默认的@app/views路径，避免硬编码路径或手动复制文件导致维护困难。
配置主题路径与启用机制
第一步：在config/web.php的components数组中添加view组件配置：
'view' => [ 'class' => 'yii\web\View', 'theme' => [ 'class' => 'yii\base\Theme', 'pathMap' => [ '@app/views' => '@app/themes/mytheme/views', '@app/widgets' => '@app/themes/mytheme/widgets', ], 'baseUrl' => '@web/themes/mytheme', ], ],
第二步：确保@app/themes/mytheme目录真实存在且结构完整——必须包含views/子目录，否则首次访问会抛出Invalid Route异常；若widgets/目录不存在，可省略该行映射，但后续自定义小部件将无法被主题接管。
第三步：清空runtime/cache/和runtime/compiled_views/目录，否则旧视图缓存会跳过主题路径直接读取原视图，导致主题不生效。
主题内布局文件的正确放置方式
主题的布局文件不能放在@app/themes/mytheme/layouts/下就自动可用——【必须在主题的views目录内创建layouts子目录】，即完整路径为@app/themes/mytheme/views/layouts/main.php。
若控制器中设置了$this->layout = 'main'，Yii会先在@app/themes/mytheme/views/layouts/查找，找不到才回退到@app/views/layouts/；但若写成$this->layout = '@app/views/layouts/main'，则完全绕过主题机制，强制使用原始布局。
这一步操作起来很简单，直接把@app/views/layouts/main.php复制进@app/themes/mytheme/views/layouts/即可开始定制。
覆盖内置小部件样式与行为
方法一：替换小部件视图文件
在@app/themes/mytheme/widgets/下创建对应小部件的子目录结构，例如覆盖yii\widgets\Breadcrumbs，需新建@app/themes/mytheme/widgets/breadcrumbs/index.php，内容可完全重写HTML结构，也可继承原视图：<?php echo $this->render('@yii/widgets/breadcrumbs/index', ['links' => $links]); ?>。
方法二：扩展小部件类并绑定主题视图
新建@app/themes/mytheme/widgets/MyBreadcrumbs.php，继承yii\widgets\Breadcrumbs，重写getViewPath()方法返回Yii::getAlias('@app/themes/mytheme/widgets/breadcrumbs')；然后在主题视图中用use app\themes\mytheme\widgets\MyBreadcrumbs;调用——【注意：此时必须在config/web.php中通过'classMap'注册该类，否则自动加载失败】。
静态资源（CSS/JS）的主题化注入
第一步：在主题根目录下创建assets/文件夹，放入css/、js/、images/等子目录。
第二步：新建@app/themes/mytheme/AssetBundle.php，内容如下：
namespace app\themes\mytheme; use yii\web\AssetBundle; class AssetBundle extends AssetBundle { public $sourcePath = '@app/themes/mytheme/assets'; public $css = ['css/style.css']; public $js = ['js/main.js']; public $depends = ['yii\web\YiiAsset']; }
第三步：在主题的views/layouts/main.php顶部调用app\themes\mytheme\AssetBundle::register($this);，不要用AppAsset::register($this)——后者会加载应用级资源，与主题隔离目标冲突。
第四步：确认web/themes/mytheme/assets/目录已通过Nginx/Apache可公开访问，否则浏览器会404加载style.css；宝塔环境下需检查站点伪静态是否拦截了/themes/路径，必要时在伪静态规则末尾加location ^~ /themes/ { } 放行。
