ThinkPHP的{include}标签必须使用模板目录下的相对路径，如{include file="public/header"}；跨模块用"模块@路径"，绝对路径用"/路径"；传参需字符串键值对，静态资源须用{__STATIC__}避免路径错误。
ThinkPHP 的 {include} 标签怎么写路径才不报错
路径写错是 90% 的引入失败原因。ThinkPHP 的 {include} 不走 PHP 的 include_path，也不认相对路径（比如 ../common/header.html），它只认「模板目录下的相对路径」，且默认从当前模板所在目录开始找。
- 正确写法：
{include file="public/header"}→ 表示引入view/public/header.html - 跨模块引用：
{include file="admin@public/header"}→ 引入view/admin/public/header.html（前提是admin是有效模块名） - 绝对路径写法（推荐）：
{include file="/public/header"}→ 从view/根目录开始，对应view/public/header.html - 错误示范：
{include file="./header"}或{include file="header.html"}→ 会尝试在当前模板同级目录找，极易 404
传参给被包含模板时，{include} 的语法和变量作用域要注意什么
被包含模板里的变量默认继承父模板作用域，但显式传参更可控、可读性更强；注意不能用 PHP 语法传数组字面量，必须用字符串键值对形式。
- 传单个变量：
{include file="public/header" title="首页"}→ 在header.html中直接用{$title} - 传多个变量：
{include file="public/header" title="首页" is_login=1 user_name=$user.name} - 不能这样写：
{include file="public/header" data="['title'=>'首页']"}→ ThinkPHP 不解析这种 PHP 数组语法 - 如果要传复杂数据，建议在控制器里赋值好（如
$this->assign('header_data', $data)），然后{include file="public/header" header_data=$header_data}
为什么 {include} 引入的头部没生效，或 CSS/JS 路径全乱了
这不是 {include} 本身的问题，而是 HTML 资源路径相对于当前 URL 解析导致的。包含只是拼 HTML 字符串，不会自动修正 <link> 或 <script></script> 的 href/src。
- 静态资源一律用
{__STATIC__}或{:url()}动态生成路径，例如：<link rel="stylesheet" href="%7B__STATIC__%7D/css/base.css"> - 避免写死路径如
href="css/base.css"—— 如果当前 URL 是/admin/user/index，浏览器会去请求/admin/user/css/base.css - 如果用了子域名或 CDN，检查
__STATIC__配置是否正确（通常在config/template.php或config/app.php中）
在布局模板（layout）里用 {include} 和 {block} 混用时容易卡在哪
ThinkPHP 布局继承机制中，{include} 是内容替换，{block} 是区域填充，两者嵌套顺序和层级很容易冲突——尤其是把 {include} 放在 {block} 外部时，被包含模板里的 {block} 可能无法被识别。
立即学习“PHP免费学习笔记（深入）”；
- 安全做法：公共头尾统一用
{include}，页面主体用{block name="body"}，不要在header.html里再定义{block} - 如果头尾也需要动态区块（比如不同页面头部菜单不同），改用
{extend}+ 多层 layout，而不是在{include}里塞{block} - 调试技巧：开启模板编译调试（
'template' => ['strip_space' => false]），查看缓存后的 PHP 文件，确认{include}是否真被展开、变量是否传进去了
public/header 和 /public/header 看似只差一个斜杠，但前者按模块相对查找，后者强制根目录，混用会导致某些页面正常、某些页面 404，而且错误不报在日志里，只静默失效。 
