PHPStudy配置Xdebug调试需三步：启用扩展、正确配置php.ini（xdebug.mode=debug、client_port=9003等）、IDE监听端口一致；重启服务后通过phpinfo验证，再在PhpStorm或VSCode中设置对应调试环境。
用PHPStudy配置PHP调试模式，核心是让Xdebug扩展正确加载并和IDE（如PhpStorm或VSCode）通信。整个过程不复杂但容易忽略细节，关键在三处：启用Xdebug扩展、写对php.ini配置、确保IDE监听端口一致。
确认并启用Xdebug扩展
新版PHPStudy Pro已内置Xdebug（无需手动下载DLL）。操作路径为：其他选项 → PHP扩展及设置 → PHP扩展，在列表中勾选对应PHP版本的xdebug。勾选后会自动向php.ini末尾写入类似这样的行：
zend_extension="D:/phpstudy_pro/Extensions/php/php7.4.3nts/ext/php_xdebug.dll"若未自动添加，可手动补上——注意路径用正斜杠或双反斜杠，避免转义错误；路径必须指向真实存在的php_xdebug.dll文件。
修改php.ini关键配置项（Xdebug 3.x适用）
打开当前PHP版本所用的php.ini（可通过<?php phpinfo(); ?>确认路径），在文件末尾添加或修正以下内容：
立即学习“PHP免费学习笔记（深入）”；
- xdebug.mode=debug —— 启用调试模式（不是remote_enable）
-
xdebug.start_with_request=yes —— 每次HTTP请求自动启动调试，不用手动加
?XDEBUG_SESSION_START=PHPSTORM - xdebug.client_host=127.0.0.1 —— IDE运行在本机时填这个
- xdebug.client_port=9003 —— Xdebug 3默认端口，务必与IDE中设置完全一致（旧版Xdebug 2用9000）
-
xdebug.idekey=PHPSTORM —— 大小写敏感，需和PhpStorm里设置的Key一致；VSCode建议设为
vscode - xdebug.log="C:/phpstudy_pro/Extensions/tmp/xdebug.log" —— 开启日志，便于排查连接失败问题
重启服务并验证是否生效
保存php.ini后，在PHPStudy控制面板中重启Apache或Nginx服务（MySQL不用重启，但Apache/Nginx必须重起）。新建一个info.php，内容为<?php phpinfo(); ?>，浏览器访问http://127.0.0.1/info.php，搜索页面是否有Xdebug区块，且显示“enabled”和正确版本号。若无显示，检查三点：php.ini路径是否正确、zend_extension路径是否存在、xdebug.log里是否有加载失败记录。
配置IDE监听（以PhpStorm和VSCode为例）
PhpStorm：进入File → Settings → PHP → Debug，把Xdebug port设为9003；点击右上角电话图标Start Listening for PHP Debug Connections。再配一个Run/Debug Configurations → PHP Web Page，指定服务器地址（如csdntest:80）和浏览器即可。
VSCode：安装PHP Debug插件后，按Ctrl+Shift+D打开调试面板 → 点击齿轮图标生成launch.json → 确保配置中"port": 9003，并设置"pathMappings"将远程路径映射到本地项目目录（例如"C:/phpstudy_pro/WWW": "${workspaceFolder}"）。
