Xdebug变量面板空白主因是pathMappings映射错误或xdebug.mode=debug未生效；需用php --ini和xdebug_info()确认配置路径与mode值，严格匹配服务器/本地路径及端口9003。
Xdebug 调试时变量面板空白或显示 undefined，90% 是路径映射错位或 xdebug.mode 未启用调试模式，不是 PHPStorm 版本问题，也不是 Xdebug 没装上。
确认 xdebug.mode=debug 是否真正生效
Xdebug 3.0+ 默认关闭所有功能，光装扩展、配好 IDE 还是白搭。必须让 PHP 进程实际加载了含 xdebug.mode=debug 的配置。
- 别只改
php.ini就完事——先分清你调的是 Web 还是 CLI：Web 请求查<?php phpinfo(); ?>页面里的Loaded Configuration File；CLI 脚本用php --ini看 - 在代码里加一行
xdebug_info();，浏览器或终端执行，直接看输出里mode值是不是包含debug - 如果显示
develop或空值，说明配置没加载，或者被其他.ini文件覆盖（比如xdebug.ini里又写了xdebug.mode=off）
pathMappings 配错导致变量上下文丢失
PHPStorm 不知道服务器上的 /var/www/html/index.php 对应你本地的 /Users/me/project，断点能停，但所有变量都变灰、悬停无值、$this 显示 undefined。
- 打开
xdebug_info()输出，找$_SERVER['SCRIPT_FILENAME']或file://开头的绝对路径，这就是 Xdebug 实际传过来的文件地址 - PHPStorm 设置路径映射：File → Settings → Languages & Frameworks → PHP → Servers → 编辑对应服务器 → 填写
Path mappings - 左边填服务器路径（必须以
/结尾，如/var/www/html/），右边填本地项目根目录（如$PROJECT_DIR$） - Linux/macOS 注意大小写和斜杠方向；Windows 下路径如
C:\xampp\htdocs\要写成C:/xampp/htdocs/格式才匹配
IDE 监听端口与 Xdebug 连接端口不一致
端口对不上，Xdebug 会静默失败，PHPStorm 不报错也不弹窗，变量面板永远空着。
立即学习“PHP免费学习笔记（深入）”；
- 检查
php.ini中xdebug.client_port（默认9003），不是旧版的xdebug.remote_port - PHPStorm 设置：Settings → Languages & Frameworks → PHP → Debug → Xdebug →
Debug port必须完全一致 - 终端执行
telnet 127.0.0.1 9003，如果返回Connection refused，说明 PHPStorm 没在监听，或被防火墙拦截 - 多 PHP 版本共存时（如通过 phpbrew 或 asdf），确保 PHPStorm 的 CLI interpreter 指向的 PHP 版本，和 Web 用的是同一套配置
为什么悬停变量还是看不到对象属性？
不是配置问题，是默认行为限制：PHPStorm 只展开一级变量，深层嵌套或大数组会被截断，且不自动调用 __get 或访问私有属性。
- 鼠标悬停后按
Ctrl（macOS 是Cmd）可强制展开一层 - 在 Variables 面板右键变量 →
View as Array或View as Object切换查看方式 - 如果对象用了魔术方法或属性被
protected/private修饰，需确认类里有没有加#[\ReturnTypeWillChange]或__debugInfo()方法 - 避免在调试时依赖
var_dump()输出——它走的是 HTTP 响应流，不会出现在调试控制台
最易忽略的一点：xdebug.show_local_vars=1 这个开关在 Xdebug 3 里依然有效，但它只影响 xdebug_info() 输出中的局部变量列表，不影响 PHPStorm 变量面板。真要排查，优先盯死 xdebug.mode 和 pathMappings，其余都是次要干扰项。
