ThinkPHP 默认不自动加载 .env 文件，需确保其位于项目根目录、在 App::initialize() 前调用 load_dotenv()、避免提前使用 Env::get()，并注意 APP_ENV 切换逻辑及 Swoole/CLI 下的手动加载。
为什么 .env 文件里的变量在 ThinkPHP 里读不到
ThinkPHP 默认不会自动加载 .env 文件，除非你显式调用 load_dotenv() 或启用了环境配置自动加载机制。常见现象是：env('APP_DEBUG') 返回 null 或默认值，但 .env 明明写了 APP_DEBUG=true。
原因通常是：框架启动流程中 .env 加载时机不对、路径错误、或被后续配置覆盖。ThinkPHP 6+ 使用 think-env 扩展（基于 vlucas/phpdotenv），它只在 App::initialize() 阶段前生效，且默认只读取项目根目录下的 .env。
-
.env必须放在public同级目录（即项目根目录），不是public/或config/下 - 确保没有在
bootstrap/app.php里提前调用Env::get()—— 此时.env尚未加载 - 若使用 Swoole 或 CLI 模式，需手动触发加载（
DotEnv::load()），不能依赖 HTTP 生命周期
如何确认 .env 是否真的被加载了
最直接的办法是绕过 ThinkPHP 的封装，用原生 phpdotenv 检查环境变量是否进到 PHP 的 $_ENV 或 getenv()。
在 public/index.php 顶部加几行调试代码（上线前务必删掉）：
立即学习“PHP免费学习笔记（深入）”；
<?php
// public/index.php 开头插入
$dotenv = Dotenv\Dotenv::createImmutable(__DIR__.'/..');
$dotenv->safeLoad(); // 不抛异常，静默失败也继续
var_dump($_ENV['APP_DEBUG'] ?? 'not set in $_ENV');
var_dump(getenv('APP_DEBUG')); // 注意：getenv() 可能受 php.ini 中 variables_order 影响
exit;
如果两个都为 bool(false) 或 'not set'，说明文件没加载成功；若其中一个有值，说明加载成功但 ThinkPHP 的 env() 函数没桥接过去（见下一点）。
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
-
safeLoad()比load()更适合调试 —— 它不因文件不存在或语法错误而中断脚本 - 注意
variables_order配置：若 php.ini 中variables_order = "GPCS"（不含E），getenv()会失效，必须用$_ENV - ThinkPHP 的
env()函数底层优先读$_ENV，再 fallback 到getenv()，所以两者都要验证
env() 函数返回 null 的真实原因和修复方式
env() 不是魔术函数，它只是对 $_ENV / getenv() 的封装 + 缓存，不会主动 reload .env。一旦初始化完成，改了 .env 也不生效，除非重启服务（尤其 Swoole、Workerman）。
典型陷阱是：在配置文件（如 config/app.php）里直接写 'debug' => env('APP_DEBUG', false)，但此时 env() 还没准备好 —— 因为配置加载早于 .env 解析。
- ThinkPHP 6.1+ 把
.env加载提前到了think\App构造阶段，但自定义配置文件仍可能在更早时机被 require - 安全起见，所有依赖环境变量的配置项，应放在
config/目录下的「动态配置文件」中（如config/debug.php），并确保该文件由框架按需加载（非直接require） - CLI 下运行
php think run时，需确认当前工作目录是项目根目录，否则__DIR__.'/..'会指向错误路径
多环境切换时 .env 加载失败的隐藏条件
ThinkPHP 支持 .env.production 等后缀文件，但**只有设置 APP_ENV 后才会尝试加载对应文件**，且它不会合并，而是完全替换主 .env。也就是说，APP_ENV=production 会导致只加载 .env.production，忽略 .env。
常见错误是：本地开发写 APP_ENV=local，但没建 .env.local，结果所有变量都丢失。
- 检查
APP_ENV值是否拼写正确（local≠dev），且对应文件存在 - ThinkPHP 不支持「叠加加载」，
.env+.env.local不会合并，只加载后者 - 若需共享变量，把通用项写进
.env，差异化项写进带后缀的文件，并确保APP_ENV设置正确 - Swoole 热重载不刷新
.env，改完必须php think swoole:restart
环境变量这层看似简单，实际卡在路径、时机、PHP 配置、框架加载顺序四重边界上。调不通时，先盯住 $_ENV 和当前工作目录，比翻文档更快。
