ThinkPHP的config()读不到新配置是因为配置一次性加载并全局缓存，运行时修改文件无效；需调用config(null, true)清缓存（仅调试），且须注意键名路径规则、作用域、.env加载及特殊字符转义。
为什么 config() 读不到你刚改的配置？
因为 ThinkPHP 的配置是「一次性加载 + 全局缓存」的，不是每次调用 config() 都重新读文件。你在运行时修改了 app/config/database.php，但框架早已把旧值塞进内存，config('database') 拿到的还是缓存里的快照。
- 开发阶段想实时看到改动？加一句
config(null, true)清空缓存（仅限调试，别放生产） - 配置文件里用了 PHP 表达式（比如
env('DB_HOST')），确保.env已加载且变量存在，否则config()返回null或默认值 - 自定义配置文件没被自动加载？得在
app/config/app.php的'config' => []数组里显式声明路径，比如'extra' => ['myconf']，对应app/config/myconf.php
config() 取值时路径写错的典型表现
ThinkPHP 的配置键是点号分隔的扁平路径，不是嵌套数组的访问语法。写成 config('database.connections.mysql.host') 是对的；写成 config('database')['connections']['mysql']['host'] 就会报错或返回空——因为 config() 本身不返回数组，它只做键值查找。
- 多级键名必须用字符串，不能拆成数组下标：✅
config('cache.default')，❌config('cache')['default'] - 键名区分大小写：
config('app_debug')和config('APP_DEBUG')是两个不同键（后者通常不存在） - 取整个配置段用点号结尾：
config('database.')（注意末尾点），返回该前缀下的所有子项组成的数组
在命令行或中间件里调用 config() 报 Call to undefined function config()
这个错误说明当前作用域没加载 think\helper\config 辅助函数。ThinkPHP 6+ 默认只在 HTTP 应用生命周期中自动引入助手函数，而命令行、定时任务、单元测试等场景需要手动补全。
- 最简方案：在入口文件或命令类开头加
use think\facade\Config;，然后用Config::get('app.name')替代config() - 如果坚持用函数式调用，在
composer.json的"autoload"→"files"里加上"vendor/topthink/framework/src/helper.php"，再执行composer dump-autoload - 注意：
config()函数本质就是Config::get()的封装，两者行为完全一致，选一个统一用就行
配置值里含特殊字符（如斜杠、冒号）导致解析异常
ThinkPHP 会把配置值中的 : 当作类型转换标记（比如 '123:integer' 转成整型），把 / 在某些上下文里误判为路径分隔符。这不是 bug，是设计使然，但容易踩坑。
立即学习“PHP免费学习笔记（深入）”；
- 密码、密钥、URL 等含
:或/的值，务必用单引号包裹：'password' => 'abc:def/ghi'，而不是"abc:def/ghi"（双引号可能触发额外解析） - 如果值本身就是布尔或数字，但你想强制当字符串用，加空格绕过类型推断：
'flag' => 'true '（末尾空格） - 环境变量注入时（
env('API_URL')），确保.env文件里该值也用引号包住：API_URL="https://api.example.com/v1"
config() 返回意料之外的结果。尤其在跨环境部署时，.env 和配置文件的优先级关系、是否启用配置缓存，这些细节比语法本身更容易出问题。 
