助手函数是ThinkPHP6运行时环境的一部分，非语法糖；HTTP请求外场景需手动加载或改用Facade类。
助手函数不是“语法糖”，而是 ThinkPHP6 运行时环境的一部分；没加载就用，直接报 Call to undefined function —— 这是 90% 的新手卡住的第一步。
为什么 dump()、config() 突然报错？
ThinkPHP6 的助手函数（如 dump、config、env、app）默认只在 HTTP 请求生命周期中自动引入。命令行、定时任务、单元测试、自定义 Artisan 命令等场景下，它们根本不在作用域里。
- 最常见现象：
Call to undefined function dump()或Call to undefined function config() - 别急着重装框架——先检查是否漏了
composer dump-autoload - 若已执行 autoload，仍报错：入口文件或命令类顶部加
use think\facade\Config;，改用Config::get('app.name') - 坚持用函数式？在
composer.json的"autoload": {"files": [...]}中手动加入"vendor/topthink/framework/src/helper.php"，再运行composer dump-autoload
config() 读不到你刚改的配置？
ThinkPHP 的配置是「一次性加载 + 全局缓存」，不是每次调用都重新读文件。你在 config/database.php 里改了 'host' => '127.0.0.1'，但 config('database.host') 还返回旧值，就是这个原因。
- 开发调试时可临时清缓存：
config(null, true)—— 注意：仅限本地，生产环境禁用 - 取值必须用点号路径：
config('cache.default')✅，config('cache')['default']❌（会返回null或触发 notice） - 键名严格区分大小写：
config('app_debug')和config('APP_DEBUG')是两个不同键 - 想取整个子段？末尾加点：
config('database.')返回所有以database.开头的配置项组成的数组 - 自定义配置文件（如
app/config/myconf.php）需在config/app.php的'extra' => ['myconf']中显式声明
env() 和 .env 文件不生效？
env() 不是读取 .env 文件本身，而是读取 PHP 运行时的环境变量。ThinkPHP 只在启动阶段通过 Dotenv 加载一次 .env 到 $_ENV，后续调用 env() 实际查的是内存里的 $_ENV。
立即学习“PHP免费学习笔记（深入）”；
- 修改
.env后必须重启 Web 服务或 CLI 进程（FPM/CLI 不共享环境变量） -
env('DB_HOST', '127.0.0.1')中的默认值只在$_ENV['DB_HOST']完全未设置时才生效；若设为空字符串，env()仍返回空，不会兜底 - 配置文件中写
'host' => env('DB_HOST')没问题，但确保.env已被加载（检查bootstrap/app.php是否有Dotenv\Dotenv::createUnsafeImmutable(...)->load();） - 部署到某些容器或 PaaS 平台时，
.env可能被忽略，优先用平台提供的环境变量注入方式
dump() 调试时输出乱码或截断？
dump() 默认使用 var_dump 封装，对大数组、对象或递归结构容易崩溃或显示不全，尤其在 CLI 下无 HTML 渲染支持。
- CLI 环境建议加
die配合：dump($data); die;，避免后续逻辑干扰输出 - 查看深层嵌套结构时，用
dump($data, true)强制展开全部层级（第二个参数为true） - 不想输出到页面？用
file_put_contents('php://stderr', print_r($data, true));写 stderr，更符合 CLI 习惯 - 生产环境切记关闭调试模式（
APP_DEBUG=false），否则dump()可能暴露敏感数据
真正容易被忽略的点是：助手函数的「加载时机」和「作用域边界」。它们不像类方法那样有明确命名空间约束，一旦脱离框架预设上下文，就只是普通 PHP 函数——而 PHP 不会自动帮你 include。所以与其反复查文档，不如把 composer dump-autoload 和 use think\facade\Xxx 当成肌肉记忆。
