yii2主题配置需在每个模块中单独声明，全局设置无效；模块内render()才受主题影响，renderpartial()等不生效；pathmap必须用合法别名，baseurl须为web可访问路径且与basepath匹配。
Yii2 中 theme 配置只对当前模块生效，全局设置无效
Yii2 的主题机制是按模块隔离的，theme 必须在每个模块的配置里单独声明，不能只在 web.php 顶层写一次就覆盖所有模块。你改了 Application::theme，但 Module::theme 没配，那模块里的视图照样走默认主题。
实操建议：
-
modules数组中每个模块都显式配'theme' => ['pathMap' => [...], 'baseUrl' => ...] - 如果多个模块共用同一套主题路径，可提前定义变量，避免重复写死路径：
$commonTheme = ['pathMap' => ['@app/views' => '@app/themes/mytheme/views']] - 注意：模块内若调用
$this->render()，它优先查模块自己的theme；若模块没设，才 fallback 到应用级theme（但这个 fallback 在 2.0.40+ 后已被弱化，不建议依赖）
多主题切换时 pathMap 映射路径必须以 @ 别名开头，不能用相对路径
常见错误是把 pathMap 写成 ['@app/views' => './themes/dark/views'] 或 ../themes/dark/views，这会导致 Yii 找不到目标目录，报 Invalid path alias 或直接静默失败，视图仍渲染原样。
实操建议：
- 所有映射源和目标路径都必须用合法别名，比如
'@app/themes/dark/views'、'@app/themes/light/widgets' - 确保别名已注册：在
common/config/bootstrap.php或入口文件中调用Yii::setAlias('@themes', dirname(__DIR__) . '/themes') - 调试技巧：打印
Yii::getAlias('@themes')看是否解析正确；用is_dir()检查映射后的物理路径是否存在
模块启用主题后，renderPartial() 和 renderAjax() 仍走默认路径
这是最容易被忽略的坑：Yii 主题机制只影响 render()，不接管 renderPartial()、renderAjax() 或手动 require 视图文件的行为。换肤后弹窗或局部刷新内容还是老样式，你会以为主题没生效。
实操建议：
- 统一用
$this->render()，避免裸调renderPartial()；如必须用，手动指定主题路径：$this->renderPartial('@app/themes/mytheme/views/site/_form') - 自定义一个
renderThemedPartial()方法，在模块基类里封装路径替换逻辑 - 检查第三方扩展（如
yii2-grid）是否硬编码了视图路径，它们不会自动适配主题
生产环境启用主题后 CSS/JS 文件 404，baseUrl 配错是主因
主题的静态资源（CSS/JS）要能被 Web 访问，必须配对 baseUrl 和 basePath。常见错误是只设了 basePath（对应物理路径），却漏掉 baseUrl（对应 URL 路径），导致 AssetBundle 生成的链接指向 /assets/xxx.css 而不是 /themes/dark/css/style.css。
实操建议：
-
baseUrl必须是 Web 可访问的 URL 路径，比如'@web/themes/dark'，且确保该路径下有真实文件 - 不要用
https://开头的绝对 URL；Yii 不会解析它，会直接拼到<link>标签里导致跨域或协议错误 - 验证方法：打开浏览器开发者工具，看 Network 面板里 CSS 请求的 URL 是否符合预期；检查
AssetManager::publish()是否被意外触发（它会把主题资源复制到@web/assets，破坏换肤意图）
baseUrl 指向空目录、或者用了绕过主题链路的渲染方式，都会让换肤看起来像没动过。
