Webman 的 view() 不支持 @include，需用 require 结合 app_path() 实现局部视图复用，变量自动继承，路径须显式指定，避免作用域和 I/O 陷阱。
Webman 的 view() 函数默认只支持一次性渲染整个模板文件，不原生提供类似 Laravel 的 @include 或 Twig 的 {% include %} 局部复用能力——但你完全可以用原生 PHP 模板 + 显式 require 实现局部视图，且更轻量、无编译开销。
为什么 view() 渲染后无法直接用 @include
Webman 默认的 view 组件基于 ThinkPHP 的 think-view，它只解析 .html 或 .php 后缀模板，且不内置 Blade/Twig 解析器。你在模板里写 @include('header') 会被当作文本原样输出，不会执行包含逻辑。
-
view()返回的是已执行完毕的字符串，不是可再编译的模板对象 - 没有注册
@include指令处理器，该语法在think-view中无定义 - 试图启用 Blade 或 Twig 来获得
@include会引入额外依赖和缓存路径冲突，得不偿失
用 require() 实现真正的局部视图复用
既然 Webman 的视图目录（如 app/view/）本质就是 PHP 文件集合，最直接的方式是把局部视图写成纯 PHP 片段，在主模板中用 require 引入——它天然支持变量作用域继承，且零配置。
- 局部视图文件命名建议带
_前缀，如app/view/_header.php，避免被误作路由入口 - 主模板中直接写：
<?php require app_path('view/_header.php'); ?> - 局部视图内可直接使用父模板传入的所有变量（
$title、$user等），无需额外extract() - 若需传参隔离，可封装为函数：
<?php _render_partial('header', ['class' => 'dark']); ?>，并在公共 helper 中定义
局部视图的路径与作用域陷阱
容易忽略的是 require 的路径解析上下文：它始终相对于当前 PHP 执行脚本（即 Webman 的底层渲染器），不是相对于模板文件本身。硬写相对路径会失效。
立即学习“PHP免费学习笔记（深入）”；
- 错误写法：
require '_header.php';—— 报错Failed opening required '_header.php' - 正确写法：
require app_path('view/_header.php');或require __DIR__ . '/_header.php';（前提是确认__DIR__指向app/view） - 若局部视图需读取其他子目录（如
app/view/partials/），必须显式拼全路径：app_path('view/partials/menu.php') - 局部视图中不要用
return，否则中断主模板执行；可用ob_start()+ob_get_clean()封装输出逻辑
性能与协程兼容性提醒
局部视图本质是同步 require，在高并发协程场景下，频繁磁盘 I/O 可能成为瓶颈。但相比 Blade 编译或 Twig 缓存写入，它的开销仍低得多。
- PHP OPcache 已缓存局部视图的字节码，重复
require不触发重解析 - 不要在局部视图里做
file_get_contents或数据库查询——这会阻塞协程 - 若局部内容需异步加载（如用户头像、实时通知），应改用前端 AJAX，而非服务端
require
真正需要动态组合的复杂局部视图，优先考虑前端组件化；服务端局部复用，就老老实实用 require + app_path()，别绕弯子。
