最常见的问题是缓存未清除，需删除runtime/temp目录；配置必须放在config/view.php中，且变量名拼写正确（如__ROOT__不能少下划线），替换仅作用于HTML输出，对JSON、Word导出等无效。
模板输出替换配置不生效怎么办
最常见的问题不是配置写错了，而是缓存没清。ThinkPHP 会把模板编译后的内容缓存在 runtime/temp 目录下，哪怕你改了 view_replace_str 或 TMPL_PARSE_STRING，旧的编译结果还在，替换自然不会触发。
- 单应用模式下，删掉
runtime/temp目录即可；多应用模式要进对应应用子目录，比如runtime/admin/temp - 如果用的是 ThinkPHP 5.x，确认配置项名是
view_replace_str，不是旧版的TMPL_PARSE_STRING - 配置必须放在全局视图配置中（如
config/view.php），不能只写在控制器里——除非你用$this->fetch()的第三个参数传局部替换规则
__ROOT__、__PUBLIC__ 等内置变量在哪定义的
这些不是“用户定义”的，而是框架启动时硬编码注入的。源码里位于 ContentReplaceBehavior.class.php（TP3.2）或 think\template\driver\File.php（TP5+）中，按顺序拼接出 __ROOT__、__PUBLIC__、__CSS__ 等默认值。
-
__ROOT__是当前域名后的路径，不含协议和域名，比如访问https://example.com/admin/index，__ROOT__就是/admin -
__PUBLIC__默认等于__ROOT__.'/Public'，但你可以通过配置覆盖它，例如'__PUBLIC__' => '/static' - 自定义变量如
__LAYUIADMIN__必须显式写进view_replace_str，否则模板里写了也不会被替换
想替换 Word 模板里的占位符该用什么方案
别用模板引擎，那是 HTML 渲染用的。Word 是二进制 ZIP 包，得用 PhpOffice\PhpWord\TemplateProcessor 这类专用工具。
- 模板文件必须是
.docx格式，且占位符要用纯文本格式，比如${name}或[[name]]，避免用 Word 的域代码或样式嵌套 - 替换前先用
Notepad++或 VS Code 编辑模板，确保占位符没被自动转义或加样式 - 注意路径：模板文件路径要能被 PHP 读取，
file_get_contents()能打开才行，别直接用 URL 地址 - 导出后记得设响应头：
header('Content-Type: application/vnd.openxmlformats-officedocument.wordprocessingml.document');
Lite 文件里也能做字符串替换吗
不能。Lite 文件（lite.php）是框架核心类的合并与预编译产物，只影响加载效率，不参与运行时模板解析逻辑。所有替换行为都发生在 ContentReplaceBehavior 阶段，也就是模板渲染输出前的最后一环。
立即学习“PHP免费学习笔记（深入）”；
- 如果你发现替换失效，检查点永远是：配置是否加载、缓存是否清除、变量名是否拼错（比如写成
_ROOT__少了一个下划线） - Lite 文件只管“怎么更快加载类”，不管“怎么改 HTML 字符串”——这是两个完全不同的执行阶段
