ThinkPHP6的.env文件易被误提交，因默认含敏感信息，须将其加入.gitignore、执行git rm --cached .env清除缓存，并保留无值的.env.example；加载需满足env_file配置非null且文件权限可读，语法严禁等号空格、值含空格须单引号包裹，APP_DEBUG必须为true/"true"/"1"且Web需Nginx/Apache透传。
ThinkPHP6的.env文件为什么总被误提交
因为默认的 .env 文件里塞了数据库密码、API密钥这些不能进 Git 的东西，但很多人直接改完就 commit，结果敏感信息裸奔。根本不是 ThinkPHP 有问题，而是团队没把「共享配置模板」和「个人本地配置」分开。
必须做三件事：
• 把 .env 加进 .gitignore；
• 运行 git rm --cached .env 彻底从 Git 缓存里删掉（否则忽略无效）；
• 保留一个干净的 .env.example，只写键名不填值，比如 DB_HOST=127.0.0.1。
ThinkPHP6加载.env的两个硬性前提
哪怕 .env 文件存在且格式正确，TP6 也不会自动读它——除非你满足这两个条件：
• config/app.php 中的 env_file 配置项不能是 null，得显式设成 __DIR__.'/../.env'（或留空字符串也可触发默认路径）；
• .env 文件权限要让 Web 服务器用户（如 www-data 或 nginx）能读，否则静默失败，env('APP_DEBUG') 返回 false 或空字符串。
立即学习“PHP免费学习笔记（深入）”；
常见错误：在 config/database.php 里直接写 env('database.password')，但此时 .env 还没加载（框架初始化顺序问题），导致 fallback 到默认值。应统一用 Config::get('database.password') 或延迟到控制器中读取。
ThinkPHP6的.env语法踩坑清单
TP6 用 vlucas/phpdotenv 解析 .env，它对格式极其敏感，稍错就静默失效或报 Dotenv\Exception\InvalidPathException：
• 等号两侧**绝对不能有空格**：DB_PASSWORD=abc123 ✅，DB_PASSWORD = abc123 ❌；
• 值含空格或特殊字符必须用单引号：REDIS_PASSWORD='pass word!'，双引号会被 shell 解析，不推荐；
• 注释只能用 # 开头且前面不能有空格，行末注释不支持；
• 变量名只能是字母、数字、下划线，且不能以数字开头：API_V1_URL ✅，1API_URL ❌。
APP_DEBUG=true为什么没生效
调试模式是否开启，只取决于 APP_DEBUG 这个环境变量的值，且必须是布尔 true 或字符串 "true"/"1"。其他写法全无效："on"、"yes"、带空格的 " true "、带双引号的 "true" 都不行。
Web 环境下，Nginx 必须在 fastcgi_param 中显式透传：fastcgi_param APP_DEBUG $APP_DEBUG;；Apache 要确认 PassEnv APP_DEBUG 已启用。CLI 或 Swoole 启动时，需确保 .env 在应用初始化早期就被加载（如调用 think\facade\App::loadEnv()），改完 .env 后还得重启进程——OPCache 开着的话，旧值可能还缓在内存里。
