thinkphp5模板布局生效需配置、路径、占位符三者严丝合缝；layout_on开启后layout.html不生效最常见原因是配置位置错误或缓存未清，且{__content__}必须原样书写、子模板须顶格无bom地调用fetch()。
ThinkPHP5模板布局不是“开了就能用”，关键在于配置、路径、占位符三者必须严丝合缝，任一环节错位都会导致{__CONTENT__}不替换、页面裸奔或报错。
layout_on 开启后为什么 layout.html 不生效
最常见原因是配置位置错误或缓存未清。ThinkPHP5 默认读取 config/template.php（5.1+）或 application/config.php（5.0），但很多人改了 route.php 或 database.php 白忙一场。
- 确认配置写在正确的文件里：
return ['template' => ['layout_on' => true, 'layout_name' => 'layout']] -
layout_name值只是文件名，不含扩展名和路径；若设为'layout/layoutname'，则实际找的是application/index/view/layout/layoutname.html - 修改配置后必须清缓存：
php think clear或手动删掉runtime/view/下所有文件 - 检查模板引擎是否被覆盖：某些插件或自定义视图驱动会绕过 layout 配置，可临时在控制器里加
dump($this->view->engine->getConfig());看layout_on是否为true
{__CONTENT__} 替换失败的典型表现和修复
页面只显示子模板内容，没套头尾；或整个 layout.html 原样输出，{__CONTENT__} 字符串没被替换——这说明模板引擎压根没走布局流程。
- 确保子模板是通过
$this->fetch()渲染的，而非直接include或file_get_contents -
{__CONTENT__}必须原样书写，大小写、下划线、双下划线一个都不能错；{__content__}或{{__CONTENT__}}都无效 - 如果用了自定义占位符（如
'layout_item' => '{__REPLACE__}'），必须全局统一，且子模板里不能出现{__CONTENT__} - 注意：子模板开头若有 BOM、空格、
<?php标签或注释，可能导致布局解析被跳过
想局部关闭布局，别只靠配置
全局开启 layout 后，并非所有页面都要套 layout —— 比如登录页、404页、API 返回页。硬编码关掉比改配置更可靠。
- 控制器内关闭：
$this->view->engine->layout(false); return $this->fetch('login'); - 模板内关闭：在子模板第一行**严格顶格**写
{__NOLAYOUT__}（前面不能有任何字符，包括空格和 UTF-8 BOM） - 不要依赖“某个模板没写
{__CONTENT__}就自动不套”——这是误解，只要 layout_on 为 true，引擎就会尝试加载 layout 文件，找不到才报错 - 若用
{layout name="xxx" /}标签方式，则无需开启layout_on，但该标签必须出现在子模板第一行，否则无效
最容易被忽略的是静态资源路径：layout.html 里的 css、js 必须用以 / 开头的绝对路径（如 /static/css/app.css），写成 ./static/css/app.css 或 static/css/app.css 在子模板渲染时会拼错路径。这不是布局本身的问题，但会让开发者误以为布局失效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
