ThinkPHP环境变量名必须全大写加下划线，如DB_HOST✅；db_host❌、DB-Host❌、DbHost❌均无效；APP_ENV必须小写（dev/test/prod）才能正确加载对应config/子目录配置。
ThinkPHP环境变量名必须全大写加下划线
会，而且是硬性要求。ThinkPHP 的 env() 函数底层调用的是 vlucas/phpdotenv，它默认将所有键转为大写后匹配——但框架本身在解析时只认全大写 + 下划线格式的变量名。写成 db_host、DB-Host 或 DbHost 都无法被 env('DB_HOST') 正确读取，返回 false 或 fallback 到默认值。
-
DB_HOST✅ 可被识别 -
db_host❌ 返回false，即使 .env 里写了这行也无效 -
DB-Host❌ 下划线是唯一允许的分隔符，连字符不支持 -
DbHost❌ 驼峰命名不识别，框架不自动转换
APP_ENV 大小写敏感且决定配置加载路径
ThinkPHP 6+ 和 8.x 中，APP_ENV 不仅影响是否启用调试模式，更直接控制 config/ 子目录的加载逻辑：APP_ENV=prod 会让框架去读 config/prod/ 目录下的覆盖配置；而 APP_ENV=PROD 或 APP_ENV=Production 就完全不匹配，导致子目录配置被跳过。
- 必须小写：如
dev、test、prod - .env 文件中写
APP_ENV=dev✅，但若系统环境已设APP_ENV=Dev（首字母大写），框架会直接采用该值并尝试加载config/Dev/（不存在）→ 静默失败 - CLI 下验证方式：
echo getenv('APP_ENV')，不是看.env内容，而是看 PHP 进程实际拿到的值
值里的大小写不影响，但引号和空格会破坏解析
变量值本身大小写无限制（比如 DB_NAME=myapp_dev 和 DB_NAME=MyApp_Prod 都合法），但格式错误会导致整行失效——而 phpdotenv 报错极不友好，通常只是静默跳过，让你误以为“配置没生效”。
-
DB_USER=root✅ -
DB_USER = root❌ 等号两侧有空格 → 整行被忽略 -
DB_PWD='Pass@123!'✅ 含特殊字符必须单引号包裹 -
DB_PWD="Pass@123!"❌ 双引号可能触发 shell 变量展开，且部分版本不兼容 -
LOG_LEVEL=debug # 开发用❌ 行末注释不支持，整行失效
多环境切换时大小写错位最常引发“配置不生效”假象
本地测试时 .env 写着 APP_ENV=dev，但 Nginx fastcgi_param 透传了 APP_ENV=DEV，结果框架既没加载 config/dev/，也没报错，只是沿用根目录配置——这时你改 config/database_dev.php 完全没用，因为根本没进那个分支。
- 排查顺序：先
var_dump(getenv('APP_ENV'))，再var_dump(env('APP_ENV'))，两者不一致就说明被系统变量覆盖 - Web 服务器必须显式透传：Nginx 要写
fastcgi_param APP_ENV $APP_ENV;，Apache 要用SetEnv APP_ENV dev - CLI 启动时别依赖当前终端 export，用前缀方式更可靠：
APP_ENV=dev php think run
真正卡住人的从来不是“能不能配”，而是大小写和空格这种肉眼难辨的格式细节——.env 文件一旦出错，框架不会告诉你哪一行坏了，只会安静地 fallback 到默认值。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
