ThinkPHP 读不到自定义配置文件是因为未在 config/app.php 的 'extra' 数组中声明，且需确保加载时机正确、键名格式为点号分隔、避免运行时修改Config类。
ThinkPHP 读不到自定义配置文件？检查 config 目录和加载时机
ThinkPHP 默认只自动加载 app.php、database.php 等预设配置，自定义文件（比如 wechat.php）不会被自动识别。必须显式引入或注册。
- 把自定义配置放在
config/目录下，文件名用小写字母+下划线，如api_config.php - 在
app/config.php中的'extra'数组里声明它：'extra' => ['api_config']
- 确保不是在
Config::get()调用前就修改了配置目录路径，否则extra加载会失效 - 5.1+ 版本中，如果用了多应用模式，要确认当前应用的
config/目录是否覆盖了全局配置
Config::get() 返回 null？注意键名格式和作用域
ThinkPHP 的配置是分层嵌套的，直接用 Config::get('wechat.app_id') 才能取到值，不能写成 Config::get('wechat')['app_id'] —— 后者在未加载时会报错或返回 null。
- 键名必须是字符串，用点号（
.）分隔层级，如'database.hostname'，不能用数组语法 - 如果配置文件返回的是纯数组（没包一层），ThinkPHP 会把它当顶层键合并；建议统一返回带根键的结构，比如
return ['wechat' => [...]] - 命令行环境（如
php think run）和 HTTP 请求可能使用不同配置缓存，改完记得清缓存：php think clear:config
配置项里写环境变量？别硬编码，用 Env::get() 替代
数据库密码、API 密钥这类敏感信息，不该写死在 PHP 配置文件里。ThinkPHP 支持从 .env 读取，并在配置中动态替换。
- 在
.env里写：DB_PASSWORD=abc123
- 在
database.php中这样用：'password' => Env::get('DB_PASSWORD', '') - 注意：只有
think\facade\Env可以在配置文件中安全调用；不要用$_ENV或getenv()，它们可能未被初始化 -
Env::get()第二个参数是默认值，生产环境务必设为空字符串或抛异常，避免误用默认值
配置热更新不生效？别依赖运行时修改 Config 类
ThinkPHP 的配置在容器启动时就已加载并固化，运行中调用 Config::set() 只影响当前请求生命周期，且不触发任何钩子或重载逻辑。
立即学习“PHP免费学习笔记（深入）”；
- 想动态切换配置（比如灰度开关），应该用缓存（
Cache::get('feature_flag')）或数据库字段，而不是改Config -
Config::set()对框架内部组件（如数据库连接、日志驱动）基本无效，它们只读取初始化时的快照 - 调试时可用
Config::pull('database')查看当前实际加载的内容，确认是不是你改的那个文件
extra 配置的声明位置和 .env 文件的加载优先级——这两处最容易反复踩坑。 
