TP5公共函数不生效主因是加载时机或路径配置错位：app/helper.php需手动加入composer.json autoload files并执行composer dump-autoload；__PUBLIC__替换失效因配置改至config/template.php的template.tpl_replace_string且须清空runtime；helper.php中不可调用config()等依赖初始化的函数。
TP5 的公共函数（如 dump()、input()、url() 等）不生效，基本可以确定是加载时机或路径配置错位导致的——不是函数写错了，而是框架根本没“看见”它。
助手函数（如 dump/input）报 Call to undefined function
这类错误 90% 是因为 app/helper.php 没被 Composer 自动加载：
-
app/helper.php必须显式加入composer.json的"autoload": { "files": [...] }，不能靠框架自动发现 - 加完后必须执行
composer dump-autoload，否则修改无效 - 别把函数写在
thinkphp/helper.php或runtime/下——这些路径不会被扫描 - 升级自 TP5.0 的项目，原
helper.php要剪切到app/helper.php，留着旧位置会静默失效
__PUBLIC__ 替换字符串始终不解析
这是 TP5.1+ 最典型的视图替换失效问题，核心在于配置位置和缓存残留：
- 配置项已从
view_replace_str改为template.tpl_replace_string，必须写在config/template.php中 - 值可以是动态路径：
'__PUBLIC__' => $_SERVER['REQUEST_SCHEME'] . '://' . $_SERVER['HTTP_HOST'] . rtrim(dirname($_SERVER['SCRIPT_NAME'])) - 改完配置后，必须手动清空
runtime/全部内容，否则模板缓存仍用旧规则 - 若项目根目录下有
config/文件夹（与application/同级），优先读这里；否则读application/config/
自定义函数在 helper.php 里调用 config() 或 app_path() 返回空
这个坑非常隐蔽：所有路径与配置类函数（config()、app_path()、env()）都依赖应用初始化完成。而 app/helper.php 是在 autoload 阶段就被载入的，此时容器未启动、.env 未读取、配置尚未合并。
- 不要在
app/helper.php里直接调用config('app.app_debug')这类函数 - 如果真需要环境判断，改用
getenv('APP_DEBUG')（读取原始环境变量） - 路径拼接尽量用常量：
__DIR__ . '/../public'，而非依赖app_path()动态计算 - 需要完整容器上下文的逻辑，应移入服务类或中间件，而不是塞进 helper
真正容易被忽略的是：这些函数失效时几乎都不报错，只是默默返回空、false 或原始字符串。验证前先确认 runtime/ 是否清干净、composer dump-autoload 是否执行、以及函数到底是在哪个生命周期被调用的。
