ThinkPHP改.env不生效主因是加载机制跳过而非配置错误：默认不自动加载，CLI需手动调用Dotenv::safeLoad()，且受白名单、路径、编码、缓存等多重限制。
改了 .env 却没生效，不是配置写错了，而是 ThinkPHP 的加载机制在“跳过”你刚写的值——它不报错、不提示，只安静地用旧缓存或默认值顶上。
为什么 .env 加载被跳过了？
ThinkPHP 默认不会自动加载 .env，除非满足以下任一条件：
- 入口文件（如
public/index.php）里显式调用了Env::load()或兼容的Dotenv::createImmutable()->safeLoad() - 使用的是 ThinkPHP 6+ 且未禁用自动加载，但该机制仅在
App::initialize()阶段前触发，且只认项目根目录下的.env - CLI 模式（如
php think migrate）下，.env根本不加载——TP8 默认只在 Web 入口加载，CLI 需手动补一句：\Dotenv\Dotenv::createImmutable(__DIR__)->safeLoad();放在think文件末尾
.env 加载了，但 Env::get('DB_HOST') 还是 null
这不是没读到，是 ThinkPHP 的白名单机制拦住了你自定义的键：
- 从 TP5.1 起，
Env::get()默认只放行APP_ENV、APP_DEBUG等少数几个键，DB_HOST、REDIS_URL不在列表里，直接返回null - 解决办法只有两个：
\think\Env::setWhitelist(['DB_HOST', 'REDIS_URL'])（需在Env初始化前调用），或改用原生getenv('DB_HOST')（前提是php.ini中variables_order含E） - 更稳妥的做法：统一用
env('DB_HOST', '127.0.0.1')——这个函数内部绕过白名单，查$_ENV和getenv()两层
清了缓存还是不生效？检查这几个硬性条件
缓存只是表象，真正卡住的往往是底层路径和格式：
立即学习“PHP免费学习笔记（深入）”；
-
.env必须放在项目根目录（即含app/、config/、think的那层），不是public/下，也不是config/里 - 文件编码必须是 UTF-8 无 BOM；Windows 记事本默认带 BOM，会导致
safeLoad()静默失败 - 键值对必须严格
KEY=VALUE格式，等号两边不能有空格；含空格或#、$的值必须用双引号包裹，例如：DATABASE_PASSWORD="my#pass$123" - CLI 环境下执行命令时，必须在项目根目录运行（
cd /path/to/project && php think xxx），不能用绝对路径调public/index.php
为什么 config('database.hostname') 没变，但 env('DB_HOST') 是对的？
因为 ThinkPHP 配置有明确优先级：.env > 运行时动态设置 > config/database.php > 框架默认值。但这个优先级只在「配置合并阶段」起作用：
-
.env中的DB_HOST不会自动映射到config/database.php的'hostname'字段——你得在config/database.php里显式写成：'hostname' => env('DB_HOST', '127.0.0.1') - 改完
.env后，必须清掉runtime/config.php（不只是runtime/cache/），否则框架仍用缓存里的旧合并结果 - 如果用了 Swoole 或常驻进程，修改后需重启服务，否则
runtime/config.php缓存不会自动更新
最常被忽略的一点：多环境切换靠的是系统级 APP_ENV 变量（export APP_ENV=testing），不是 .env 里写 APP_ENV=testing 就能自动加载 config/testing/ 下的配置——后者必须存在同名文件（哪怕只是空数组），否则框架直接忽略。
