最常见原因是xdebug.mode未设为develop或debug；需用php -i确认实际值，再配对pathMappings、端口9003及max_depth等显示参数。
PHP调试时Xdebug不显示变量值怎么办
最常见原因是xdebug.mode没设对。Xdebug 3之后不再用xdebug.remote_enable这类旧配置，必须显式启用develop或debug模式。如果只开了trace，var_dump()和断点里的变量查看依然不会生效。
-
xdebug.mode=debug：启用断点调试（配合IDE） -
xdebug.mode=develop：启用var_dump()增强输出、函数参数提示等开发辅助功能 -
xdebug.mode=off：即使扩展加载了，所有Xdebug功能也关闭
检查方式：运行php -m | grep xdebug确认加载，再执行php -i | grep xdebug.mode看实际值。别信php.ini里写了就算数——被覆盖或拼错很常见。
在VS Code里用Xdebug看变量要配哪些关键项
不是装了PHP Debug插件就自动能看变量。核心是launch.json里pathMappings必须对齐本地路径和容器/服务器路径，否则断点命中但变量面板为空。
-
"port": 9003：Xdebug 3默认端口，别写成老版本的9000 -
"pathMappings"示例：{"\/var\/www\/html\/": "${workspaceFolder}/"}，注意前后斜杠方向和结尾斜杠 - 确保
xdebug.client_host指向宿主机IP（Docker里常是host.docker.internal）
变量显示异常时，先停掉所有其他调试会话，避免端口冲突；再检查VS Code左下角是否显示“Listening on port 9003”——没显示说明没连上。
立即学习“PHP免费学习笔记（深入）”；
为什么var_dump($arr)还是打印原始格式，没变Xdebug美化版
因为xdebug.mode没包含develop，或者xdebug.cli_color=1没开（CLI下尤其容易漏）。Web请求还要确认xdebug.overload_var_dump=1是否为On（Xdebug 3.1+默认开启，但低版本需手动开）。
- CLI脚本调试：加
-d xdebug.mode=develop临时启用，例如php -d xdebug.mode=develop script.php - Web环境：若用Apache，确认
php_admin_value xdebug.mode "develop,debug"已写进vhost配置 - 数组嵌套过深时，默认只展开3层，调大
xdebug.var_display_max_depth=6才看得全
注意：var_dump()美化只影响输出格式，不影响变量本身；若变量是__toString()抛异常的对象，Xdebug仍会卡住或截断，这不是配置问题，是代码逻辑问题。
断点停住后变量值显示uninitialized或NULL怎么排查
不是Xdebug坏了，大概率是作用域问题。Xdebug只能读取当前栈帧可见的变量，闭包外的use变量、动态生成的属性、被unset()过的变量都会显示不全。
- 检查断点所在行是否在函数内部——类方法里直接写断点，
$this属性可能因魔术方法未触发而不可见 -
foreach循环内断点，$value可能被优化掉，改用debug_zval_dump($value)看引用计数 - 异步代码（如Swoole协程）中，Xdebug不支持协程上下文切换，变量追踪会失效
真遇到变量“消失”，优先用get_defined_vars()在断点处dump全部局部变量，比依赖IDE变量面板更可靠。
