yii2子模块复用父模块布局需手动指定路径，关键是在父模块init()中注册@parentmodule别名，子模块控制器设layout='@parentmodule/layouts/main'，避免硬编码与自动继承误区。
模块里怎么用父模块的布局文件
Yii2 的模块默认不继承父级布局，layout 属性只认当前模块或应用级别的路径。想让子模块复用父模块的布局，不能靠“自动继承”，得手动指定路径。
常见错误是直接写 'layout' => 'main'，结果 Yii 去子模块的 views/layouts/ 下找，找不到就回退到应用层 —— 但如果你的公共布局其实在父模块里，这就断链了。
- 用相对路径指向父模块视图目录：
'layout' => '@app/modules/parentModule/views/layouts/main' - 更稳妥的是用别名 +
View::setTheme()配合，但多数场景只需改layout配置 - 若父模块有独立命名空间（如
common\module\ParentModule），确保该模块的basePath已注册别名，否则@common类路径无法解析
在父模块中定义 layout 后，子模块如何安全引用
父模块的 views/layouts/ 目录必须可被其他模块访问，而 Yii2 默认只允许本模块读取自己的 views。所以关键不是“怎么写路径”，而是“路径能不能被解析”。
最容易踩的坑：没在父模块的 init() 里注册别名，导致 @parentModule 根本不存在，require 报错或静默 fallback 到应用布局。
- 在父模块类的
init()方法中加：Yii::setAlias('@parentModule', $this->getBasePath() . '/views'); - 子模块控制器中设置：
$this->layout = '@parentModule/layouts/main'; - 避免硬编码绝对路径（如
/var/www/.../layouts/main.php），破坏部署迁移性
多个子模块共用同一套布局时，如何避免冲突
如果 A、B 两个子模块都设 'layout' => '@parentModule/layouts/main'，看起来没问题，但一旦父模块升级布局结构（比如新增 section 占位符），所有子模块都会受影响 —— 这是共享布局的隐性耦合点。
不是所有子模块都需要完全一致的渲染逻辑。比如后台子模块要 sidebar，前台子模块不要，硬塞一个 layout 就得在模板里加一堆 if 判断，维护成本陡增。
- 把差异部分抽成
renderPartial()或Widget，由子模块按需调用 - 布局文件里用
$this->context判断当前控制器所属模块，动态 include 区块（慎用，会增加理解负担） - 优先考虑“布局复用”而非“布局强绑定”：父模块提供基础 layout，子模块 copy 一份做定制，再通过 trait 或基类统一管理变更点
为什么不用 Application 级 layout 而坚持用父模块 layout
因为业务隔离。比如 admin 模块和 api 模块同属后台体系，但 api 不需要 HTML 结构、CSRF token、JS 初始化脚本 —— 它们不该共用 @app/views/layouts/main.php。这时父模块（如 backend）才是语义上正确的抽象层级。
另一个现实约束：某些公司项目中，frontend 和 backend 是两个独立应用，但内部又拆出若干模块。此时“父模块 layout”是唯一能跨应用模块复用的方案。
- Application layout 属于整个入口，粒度太粗；模块 layout 属于功能域，粒度更合适
- 模块间共享 layout 的前提是它们属于同一业务上下文，否则强行复用只会让各模块越来越难独立演进
- 别忘了检查
viewRenderer配置 —— 如果用了Twig或Smarty，路径解析规则可能不同，@parentModule别名未必生效
