app.php中部分配置项仅在APP_DEBUG=true时生效，如trace、show_error_msg；lang_list等需严格格式；路径类配置须含命名空间且文件存在；多应用下子应用配置不自动合并。
改 app.php 配置项不是“改完就生效”，必须清楚哪些项依赖 APP_DEBUG、哪些被环境变量覆盖、哪些只在特定加载时机起作用——否则改了白改，甚至引发静默降级或路径错乱。
app.php 里哪些配置项实际生效取决于 APP_DEBUG
ThinkPHP 的 app.php 不是纯静态配置文件，很多键值只有在 APP_DEBUG === true 时才被读取。比如：
-
'app_debug' => env('app_debug', true)：这个值根本不会影响调试模式开关，它只控制「调试开启后是否启用 trace 面板」； -
'show_error_msg' => true：若APP_DEBUG为false，该配置直接被忽略，错误永远只显示“系统繁忙”； -
'trace' => ['type' => 'html']：同样，APP_DEBUG关闭后整个 trace 模块不加载，type 设成什么都没用。
所以别盯着 app.php 改来改去，先确认入口文件（如 public/index.php）顶部有没有 define('APP_DEBUG', ...) —— 这才是总开关。
lang_list 等多语言配置写错就完全失效
'lang_list' => ['zh-cn', 'en-us'] 看似简单，但错一个字符就让多语言彻底失灵：
立即学习“PHP免费学习笔记（深入）”；
- 必须全小写、短横线分隔，
zh_CN或ZH-CN都不识别； -
'default_lang'必须是lang_list中存在的值，否则启动时报 warning，部分语言包加载失败； -
'lang_switch_on' => true必须是布尔值true，写成字符串'true'就等于关掉； - 对应语言包路径必须严格匹配：
lang/zh-cn/common.php，目录名和文件名都不能带空格或大写。
常见现象：浏览器请求带 Accept-Language: zh-TW，但页面始终显示英文——大概率是 lang_list 里没写 zh-tw，或者 lang/zh-tw/ 目录根本不存在。
template 和 exception_handle 这类路径型配置容易漏掉命名空间
改模板引擎或异常处理器时，填的类名必须是完整命名空间，且类文件必须真实存在：
-
'exception_handle' => 'app\exception\HttpExceptionHandler'：如果app\exception\HttpExceptionHandler类没定义render()方法，或没继承\think\exception\Handle，框架启动就报致命错误； -
'template' => ['engine_type' => 'Smarty']：仅设这个不够，还得确保smarty扩展已安装，且vendor/smarty/smarty/libs/可被自动加载； - 自定义模板路径如
'view_path' => './templates/'：路径必须以.或/开头，写成templates/（相对路径）会导致 ThinkPHP 在APP_PATH下找，而不是项目根目录。
多应用下 app.php 配置不自动合并
开启多应用（app_multi => true）后，子应用如 app/admin/config/app.php 的配置默认不会合并进主配置：
- 路由命中
admin应用时，config('app.debug')读的是app/admin/config/app.php，不是根目录的； - 全局
config/app.php里的lang_list对子应用无效，每个子应用得自己配； - 想在中间件里统一控制，得用
\think\Lang::setAllowLangList(...)动态设置，而不是指望配置文件透传。
最易忽略的一点：子应用的 config/app.php 修改后，必须清空对应子应用的 runtime/ 缓存目录，否则旧配置仍被缓存加载。
