Xdebug 3中需配置xdebug.mode=debug才能启用函数调用堆栈，默认开启但依赖debug模式；须配合xdebug.start_with_request=trigger或=yes、正确端口（9003）及PhpStorm中“Show debug info for errors and exceptions”选项。
确认 Xdebug 版本和 xdebug.mode 是否启用 debug
函数调用堆栈（stack trace）在 Xdebug 中默认开启，但前提是 xdebug.mode 包含 debug（Xdebug 3）或 xdebug.remote_enable=On（Xdebug 2）。只配 profiler 或 develop 是不够的——前者只生成性能报告，后者只增强错误提示，都不触发完整堆栈捕获。
检查方式：访问 phpinfo() 页面，搜索 xdebug.mode 值。若为 develop，需改为：
zend_extension=xdebug.so xdebug.mode=debug,develop
Windows 用户注意路径写法：zend_extension="C:\xampp\php\ext\php_xdebug.dll"，引号不能省；Linux/macOS 用绝对路径，避免加载失败。
确保 xdebug.start_with_request 或 xdebug.remote_autostart 已启用
否则只有显式触发（如 URL 加 ?XDEBUG_TRIGGER=1）才会建立调试连接，而多数异常堆栈（如未捕获的 Exception）不会自动上报到 PhpStorm —— 你看到的只是 PHP 原生报错，没有可展开的调用链。
立即学习“PHP免费学习笔记（深入）”；
- Xdebug 3：设
xdebug.start_with_request=trigger（按需触发）或=yes（全请求启动） - Xdebug 2：设
xdebug.remote_autostart=1 - 端口必须与 PhpStorm 的
Debug设置页中Xdebug端口一致，默认 Xdebug 3 是9003，Xdebug 2 是9000；若冲突（如被 Docker 占用），两边都改，比如统一用9001
PhpStorm 中必须启用「Force break at first line when no path mapping specified」以外的断点策略
函数调用堆栈本身不依赖断点，但 PhpStorm 默认只在命中断点时才展示完整上下文。要让所有异常、错误、var_dump() 调用等也带堆栈，需开启两项关键设置：
- 进入
Settings → PHP → Debug → Xdebug，勾选Break at first line in PHP scripts（可选，用于入口调试） - 更重要的是：勾选
Show debug info for errors and exceptions（该选项控制是否将 PHP 错误/异常的堆栈渲染为可点击、可跳转的结构化视图） - 路径映射（
Servers配置）必须正确，否则堆栈中的文件路径显示为/var/www/html/...而非本地项目路径，无法点击跳转
验证堆栈是否真能查看：用 throw new Exception() 测试
别依赖 echo 或 print_r —— 它们不触发 Xdebug 堆栈捕获机制。写一段最小复现代码：
<?php
throw new Exception('test stack trace');
?>
在浏览器中访问该脚本，并确保已开启 PhpStorm 的「Start Listening for PHP Debug Connections」（电话图标）。如果配置正确，PhpStorm 会中断并打开一个带完整调用链的面板，左侧是 Frames 树，可逐层点开看每个函数的参数、局部变量和源码位置。
容易忽略的一点：Xdebug 3 的 xdebug.log 日志默认关闭，但一旦堆栈不显示，建议临时加一行 xdebug.log=/tmp/xdebug.log 并查日志里是否有 Connection failed 或 Could not connect to debugging client —— 这往往比界面报错更早暴露端口/防火墙/IDE 监听状态问题。
