白屏主因是PHP错误被静默屏蔽；需确认当前Web所用PHP版本及php.ini中display_errors=On、error_reporting=E_ALL，并在入口文件首行加error_reporting(E_ALL);ini_set('display_errors','1');ini_set('display_startup_errors','1');。
白屏基本就是 PHP 没把错误吐出来，phpenv 本身不处理错误显示逻辑，它只负责切换 PHP 版本；真正决定是否白屏的是当前被选中的那个 PHP 版本的配置（尤其是 display_errors 和 error_reporting）。
确认当前生效的 PHP 版本和配置文件路径
很多人以为 phpenv versions 显示了版本就万事大吉，但实际运行时用的是哪个 php.ini 才关键。白屏往往是因为你切到了某个 PHP 版本，而它自带的 php.ini 是生产环境模板（display_errors = Off）。
- 先执行
which php确认当前 shell 使用的 PHP 路径（比如~/.phpenv/versions/8.2.12/bin/php） - 再运行
php --ini，看 “Loaded Configuration File” 指向哪——常见位置如~/.phpenv/versions/8.2.12/etc/php.ini或~/.phpenv/versions/8.2.12/etc/php.ini-development - 如果输出是 “Scan for additional .ini files in: (none)”，说明没加载任何 ini，那
display_errors就是默认Off，必白屏
快速启用错误显示（绕过 php.ini 修改）
在项目入口文件（如 index.php 或 public/index.php）最开头插入三行，比改 php.ini 更快、更可靠：
error_reporting(E_ALL);
ini_set('display_errors', '1');
ini_set('display_startup_errors', '1');
注意：这仅对当前脚本生效，且必须放在所有 require、include 和输出之前；如果加完仍白屏，说明错误发生在这些设置之前（比如 require 的文件本身有语法错误）。
立即学习“PHP免费学习笔记（深入）”；
- 若用 Composer 自动加载（如
vendor/autoload.php），需确保它没报错——可在入口第一行加die(file_exists(__DIR__.'/../vendor/autoload.php') ? 'ok' : 'autoload missing'); - 某些框架（如 Laravel、ThinkPHP）会覆盖
display_errors，此时要在框架启动前插入上述三行，或检查其环境配置（如.env中的APP_DEBUG=true）
检查 PHP 版本兼容性导致的静默失败
phpenv 切换版本后白屏，很可能是代码用了新版本语法，但在旧版本下直接解析失败（Parse error），而该错误又被 display_errors=Off 吞掉。
- 用命令行验证语法：
php -l your_script.php—— 如果提示 “Errors parsing”，立刻修复，别等浏览器访问 - 常见坑：
match表达式（PHP 8.0+）、属性类型声明（PHP 7.4+）、短闭包（fn()，PHP 7.4+）、str_contains()（PHP 8.0+）在低版本中会直接报Parse error - 执行
php -v确认当前版本，并对照代码里使用的函数/语法查 PHP 官方文档的“可用版本”栏
别忽略 CLI 和 Web SAPI 的配置差异
phpenv 设置的是 shell 环境的 CLI PHP，但 Web 服务器（Apache/Nginx）可能完全没走 phpenv，而是用系统全局 PHP 或独立的 PHP-FPM 进程。这意味着你在终端跑 php -v 看到的是 8.2，但浏览器访问时实际跑的是 8.1 甚至 7.4。
- 在 Web 页面中放一个
<?php phpinfo(); ?>，重点看 “Server API”（是 Apache、FPM 或 CGI？）和 “Loaded Configuration File” 路径 - 如果 Web 用的是 PHP-FPM，要确认
php-fpm.conf或对应 pool 配置里有没有php_admin_flag[display_errors] = on这类强制覆盖项 -
phpenv对 Nginx + PHP-FPM 基本无效——它只影响当前 shell 的php命令，不影响后台常驻的 PHP-FPM 进程
最易被忽略的一点：你以为在调试 Web 请求，其实 phpenv 根本没管到它；CLI 和 Web 是两套独立配置，得分别开错误显示。
