Laravel默认通过APP_ENV环境变量区分环境，但必须配合.env文件加载和config:cache机制才生效；若仅修改APP_ENV而未同步更新APP_DEBUG等值或未重生成配置缓存，debug仍为true。
直接结论：Laravel 默认靠 APP_ENV 环境变量区分 dev 和 prod，但必须配合 .env 文件加载逻辑 + 配置缓存机制，否则改了 APP_ENV 也无效。
为什么改了 APP_ENV=prod 但 app.debug 还是 true？
因为 Laravel 在启动时会先读取 .env 文件（仅一次），再用其中的 APP_ENV 值决定加载哪个环境专属配置（实际并不存在独立文件），而 config/app.php 中的 'debug' => (bool)env('APP_DEBUG', false) 仍依赖当前 .env 内容 —— 所以你不能只改 APP_ENV，还得同步改 APP_DEBUG、APP_LOG_LEVEL 等关键项。
常见错误现象：
- 本地
.env里写APP_ENV=prod，但没关APP_DEBUG=true，结果页面仍显示异常堆栈 - 部署到服务器后，
php artisan config:cache没重跑，导致缓存里还是旧的APP_DEBUG=true - 用了 Docker，但容器启动时没把
APP_ENV传进去，PHP 进程读到的是默认production，而.env里却是dev，两者冲突
.env 文件怎么写才真正生效？
Laravel 不支持自动加载 .env.prod 或 .env.dev —— 它只认根目录下的 .env。所谓“多环境配置”，本质是靠部署脚本或运行时注入来切换这个单一文件的内容。
Laravel 13.2.0 是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。
实操建议：
- 开发机保留
.env，内容为APP_ENV=local（或dev） +APP_DEBUG=true+ 本地数据库地址 - 生产服务器上，部署流程中执行
cp .env.prod .env（前提是已准备好.env.prod文件），再运行php artisan config:cache - 不要在
.env里写APP_ENV=prod同时又留着DB_PASSWORD=123456；敏感值必须随环境隔离，.env本身不应进 Git - 如果用 CI/CD，推荐在流水线里用模板替换，比如用
sed -i "s/APP_DEBUG=.*/APP_DEBUG=false/" .env动态关闭调试
detectEnvironment() 函数现在还管用吗？
在 Laravel 5.5+ 中，bootstrap/app.php 里的 $app->detectEnvironment() 已被移除，环境判断完全交给 Illuminate/Foundation/Application 内部逻辑：它只看 getenv('APP_ENV') 或 $_ENV['APP_ENV']，不执行回调。所以自定义检测规则（比如按域名切环境）必须换方式。
替代做法：
- 在
public/index.php最开头加putenv('APP_ENV=' . ($_SERVER['HTTP_HOST'] === 'dev.example.com' ? 'dev' : 'prod')); - 用 Nginx 的
fastcgi_param APP_ENV dev;直接透传，比 PHP 层判断更可靠 - 注意：如果用了 PHP-FPM，要确认
clear_env = no，否则 FPM 会清空所有环境变量
最容易被忽略的一点：配置缓存只缓存 config/*.php 的返回值，不缓存 .env 文件本身。也就是说，你改了 .env 但没跑 php artisan config:cache，或者跑了但没清掉 bootstrap/cache/config.php，那新值就永远不会生效 —— 尤其在 prod 环境，这个文件往往被长期复用。
