XAMPP的Xdebug端口（9000或9003）常被Docker、VS Code等占用，导致断点不触发；需按Xdebug版本修改对应端口参数（client_port或remote_port），同步更新IDE配置，并确认php.ini路径、zend_extension路径正确及端口实际监听成功。
为什么XAMPP的Xdebug端口会冲突
XAMPP默认用 9000（Xdebug 2.x）或 9003（Xdebug 3.x），但这个端口常被Docker、VS Code、其他PHP环境甚至某些杀毒软件占用。一旦被占，phpinfo() 显示Xdebug已加载，但断点完全不触发——这是最典型的端口冲突表现。
修改xdebug.client_port（Xdebug 3.x）或xdebug.remote_port（Xdebug 2.x）
先确认你用的是哪个版本：打开 http://localhost/dashboard/phpinfo.php，搜索 xdebug.version。再按版本改对应参数：
- Xdebug 3.x：改
xdebug.client_port，比如设为9002或9004 - Xdebug 2.x：改
xdebug.remote_port，同样避开9000 - 必须同步改IDE（如PhpStorm/VS Code）里的Debug端口设置，否则“服务器在听，IDE没开耳”
- Windows下若用WSL2或Docker Desktop，
127.0.0.1可能不通，建议统一用host.docker.internal或查宿主机IP
php.ini里改端口后没生效？检查这三处
常见失效不是因为写错，而是被其他配置覆盖或路径不匹配：
-
zend_extension路径写错（比如漏了盘符、空格未转义、用了正斜杠/却该用反斜杠\） - php.ini 文件不是实际生效的那个——用
php --ini或phpinfo()中的 “Loaded Configuration File” 确认路径 - Apache和CLI用的不是同一个php.ini：XAMPP里
apache/bin/php.ini控Web，php/php.ini控命令行，调试Web请求必须改前者
验证端口是否真正监听成功
别只信 phpinfo()，得看系统级反馈：
立即学习“PHP免费学习笔记（深入）”；
- 重启Apache后，在CMD执行：
netstat -ano | findstr :9002（把9002换成你设的端口），有输出说明PHP进程已绑定 - 如果没输出，说明Xdebug根本没启动——回头检查
zend_extension路径和DLL文件是否存在 - 启用日志可快速定位：加一行
xdebug.log="C:\xampp\tmp\xdebug.log"，然后访问页面，看日志里有没有连接尝试记录
