TP5.1模板变量无法输出最常见原因是OPcache丢弃PHPDoc注释导致反射失败；需设opcache.save_comments=1、重启PHP-FPM、清空ThinkPHP与OPcache双缓存，并验证模板语法及变量赋值是否匹配。
ThinkPHP模板变量无法输出，最常见原因是OPcache丢弃了PHPDoc注释，导致框架反射失败；其次是模板语法错误、缓存未更新或配置未生效。问题往往不是变量写错了，而是底层机制被意外绕过。
检查OPcache是否丢弃了注释
TP5.1中{present}、{empty}、{eq}等标签，以及模型字段自动渲染，全部依赖方法上的@param等PHPDoc注释。若OPcache启用了但opcache.save_comments=0，这些注释会被直接清除，模板变量就“凭空消失”。
- 执行
php --ini确认实际加载的php.ini路径，别只看宝塔面板显示的链接 - 用
cat /usr/local/php/etc/php.ini | grep opcache.save_comments检查该值是否为1 - 确保
opcache.load_comments=1（默认是1，但需显式确认） - 改完必须重启PHP-FPM：
lnmp php-fpm restart，reload无效
清空双层缓存再验证
ThinkPHP自身有运行时缓存，OPcache还有字节码缓存，两者叠加会让旧逻辑“顽固残留”。只改配置不清理，变量照样不输出。
- 进入项目根目录，执行
php think clear:config（TP5.1）或php think clear（兼容更强） - 手动删除
runtime/cache/、runtime/template/下所有文件 - 如果用了OPcache，顺便在PHP探针或
opcache_reset()中清空一次字节码缓存
确认模板语法与变量来源是否匹配
变量能传进去，不代表能正常渲染。常见低级但致命的问题包括：
立即学习“PHP免费学习笔记（深入）”；
- 模板中用了
{$name}，但控制器里没用$this->assign('name', $value)或没返回view()带参数 - 闭合标签出错，比如
{if $a}{/if漏了右括号，会导致后续所有变量失效 - 使用了
{:xxx()}但函数不存在，或{:dump($data)}后没加exit，页面被截断 - 开启了
url_html_suffix且后缀不匹配，导致模板根本没加载成功（可查runtime/log/里是否有template not exists）
临时开启调试快速定位
关闭一切干扰，直击原始输出是否正常：
- 在
config/app.php中设'app_debug' => true，强制跳过模板缓存 - 在模板开头加
{:dump($this->getTemplateVars())}，看变量是否真传进来了 - 把模板简化到只剩
{$think.version}，如果这个都输出不了，说明是环境或入口问题，不是业务逻辑
