phpenv仅管理PHP版本切换，不加载或解析.env文件；.env需由vlucas/phpdotenv等库在PHP代码中显式加载，两者职责完全分离。
phpenv 本身不管理环境配置文件（比如 .env），它只管 PHP 版本切换；混淆这点会导致配置加载失败、本地调试连不上数据库等典型问题。
phpenv 不读取 .env 文件，也不参与配置加载
phpenv 是纯版本管理工具，它的职责仅限于修改 $PATH，让 php 命令指向指定编译安装的 PHP 二进制文件。它不会解析 .env、不调用 Dotenv::load()、也不影响 $_ENV 或 getenv() 的行为。
- 常见错误现象：在项目里执行
php -v显示是 PHP 8.2，但getenv('APP_ENV')返回false—— 这和 phpenv 无关，是环境变量根本没设或.env没被加载 - 真实使用场景：你用 phpenv 切到 PHP 7.4 跑一个老项目，同时用
vlucas/phpdotenv加载.env.dev，两者完全正交，互不干扰 - 关键区别：
phpenv local 7.4改的是解释器；export APP_ENV=dev或.env文件改的是运行时变量
如何让 phpenv 项目自动加载对应环境的 .env 文件
需要手动在项目入口（如 index.php 或 bootstrap.php）中判断当前环境并加载对应 .env 文件，phpenv 不提供这个能力。
- 推荐做法：先用
getenv('APP_ENV')尝试读系统级变量（Nginx/Apache/Docker 注入），失败再 fallback 到.env文件 - 示例逻辑：
use Dotenv\Dotenv; $env = getenv('APP_ENV') ?: 'dev'; $envFile = __DIR__ . '/.env.' . $env; if (file_exists($envFile)) { $dotenv = Dotenv::createImmutable(__DIR__, $envFile); $dotenv->load(); } else { // 回退到根目录 .env $dotenv = Dotenv::createImmutable(__DIR__); $dotenv->safeLoad(); // 避免 .env 不存在时报错 } - 注意：
Dotenv::createImmutable()第二个参数是文件名，不是后缀；不要写成'.env' . $env然后期望它自动拼路径
为什么 .env.dev 文件不被 phpenv 自动识别
因为 phpenv 根本没有「环境配置文件」这个概念。它只认三种版本作用域：global、local（项目根目录的 .php-version）、shell（当前终端临时设置）。.env 类文件属于应用层配置，由 PHP 代码自己处理。
立即学习“PHP免费学习笔记（深入）”；
- 容易踩的坑：把
.php-version和.env混为一谈，误以为phpenv local 8.3会顺带加载.env.prod - 性能影响：
vlucas/phpdotenv加载.env是纯 PHP 文件 I/O，和 phpenv 的 shell hook 无任何交集，不会拖慢版本切换 - 兼容性提示：PHP 8.1+ 默认禁用
$_ENV，需确保php.ini中variables_order包含E，否则$_ENV['APP_ENV']始终为空
真正要警惕的是把环境变量注入逻辑写死在 .php-version 里——这个文件只接受一行纯版本号（如 8.2.12），写其他内容会被 phpenv 忽略，还可能引发解析错误。
