xdebug 3.x调试需三步：确认扩展加载（php -v或phpinfo）、php.ini配zend_extension、xdebug.mode=debug等参数、phpstorm设监听端口9003并配置pathmappings，缺一不可。
ThinkPHP新手想边跑项目边看清代码执行流程，必须让PhpStorm能实时捕获请求并停在你设的断点上——这一步卡住的人，八成是Xdebug没加载、端口没对齐、或IDE Key根本没传过去。
确认Xdebug已正确加载并匹配PHP版本
别跳过这步：在ThinkPHP项目的public目录下新建info.php，内容只有一行，用浏览器访问http://localhost/tp5/public/info.php（端口按你实际配的填），右键「查看网页源代码」，全选复制整页源码。
打开xdebug.org/download页面，点击「Step 1: Copy and paste the full output」，把刚复制的源码粘进去，它会精准告诉你该下载哪个php_xdebug-*.dll（Windows）或xdebug.so（Linux/macOS），连VC版本、TS/NTS、位数都判定了。
下载后，把扩展文件放到PHP的ext目录，例如D:\phpstudy_pro\Extensions\php\php7.4.33\ext\php_xdebug-3.1.5-7.4-vc15-x86_64.dll；【务必用绝对路径，且确保文件真实存在】。
运行php -v，输出里必须带xdebug字样；若没有，说明扩展根本没启用。Xdebug 3.x要求PHP 7.4+，硬配Xdebug 2.x到PHP 8.1会导致静默失效。
配置php.ini启用Xdebug 3.x调试模式
找到phpinfo()页面中“Loaded Configuration File”指向的php.ini路径，用文本编辑器打开，在末尾添加以下最小可用配置：
zend_extension="D:/phpstudy_pro/Extensions/php/php7.4.33/ext/php_xdebug-3.1.5-7.4-vc15-x86_64.dll"
xdebug.mode=debug
xdebug.start_with_request=trigger
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.idekey=PHPSTORM
Xdebug 3彻底废弃xdebug.remote_enable这类旧参数，混用会直接失效；【xdebug.mode=debug是开关，不是布尔值，必须写成debug，不能写on/true/1】。
Windows用户填127.0.0.1比localhost更稳，避免hosts解析慢导致超时；Docker或WSL环境则必须填宿主机真实IP（如192.168.42.1），不能写localhost或127.0.0.1。
在PhpStorm中设置PHP解释器与Debug监听
打开PhpStorm → File → Settings → PHP → Interpreter，点击右侧“+”号，选择你的PHP可执行文件路径（如D:\phpstudy_pro\Extensions\php\php7.4.33\php.exe）。
PhpStorm会自动检测扩展，右侧应显示Xdebug 3.x版本号；若显示“Not installed”，说明php.ini路径不对或扩展未加载成功。
进入Settings → PHP → Debug，确认Debug Port为9003（必须与xdebug.client_port完全一致）；勾选“Can accept external connections”，否则PhpStorm直接丢弃连接请求。
点击右上角电话图标（Start Listening for PHP Debug Connections），让它变成绿色——这是调试通道开启的唯一视觉信号。
配置服务器映射并触发调试会话
第一步：Settings → PHP → Servers，点击“+”添加服务器：
• Name：tp5-local
• Host：localhost（不是127.0.0.1，除非你真用这个地址访问）
• Port：80（或你实际使用的端口，如8080）
• Debugger：Xdebug
• 勾选Use path mappings
第二步：在Path Mapping中设置映射关系：
• Local path：选中你的ThinkPHP项目根目录（如D:\www\tp5）
• Absolute path on the server：填服务器上PHP解析的真实路径（如D:\phpstudy_pro\WWW\tp5）
③ 这一步漏掉或映射反了，断点会“命中但不暂停”，变量面板为空。
第三步：安装Xdebug Helper浏览器插件（Chrome/Firefox），点击图标→Debug，它会在URL后自动追加?XDEBUG_SESSION_START=PHPSTORM；确保插件里IDE Key设为PHPSTORM，且PhpStorm中Settings → PHP → Debug → Xdebug → IDE Key也设为PHPSTORM。
在ThinkPHP控制器方法第一行打个断点，刷新浏览器页面，PhpStorm立刻弹出调试窗口并停在断点处。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
