根本原因是PhpStorm GUI启动时不继承shell环境变量，需手动配置which php或where php获取的绝对路径，在Settings→PHP→Interpreter中添加，并确保CLI php.ini启用Xdebug且端口为9003，同时正确设置服务器路径映射。
PhpStorm 里找不到 PHP 解释器路径怎么办
根本原因不是 PhpStorm 坏了，而是它压根不读你终端里配置好的 PATH —— macOS 用 Dock 启动、Windows 用快捷方式启动时，GUI 进程根本没加载 shell 的环境变量。所以 which php 或 where php 在终端里能跑，PhpStorm 却搜不到。
必须手动告诉它真实路径：
- 先在终端运行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，比如/usr/local/bin/php或C:\php\php.exe - 进 Settings → Languages & Frameworks → PHP → Interpreter，点齿轮 → Add Interpreter → Local，**不要点“Auto-detect”**，直接点击右侧“…”浏览并选中那个路径
- 选完后右下角应显示类似
PHP 8.2.12 (cli)，没显示说明路径错、权限不足，或该二进制缺依赖（如 Windows 缺msvcr120.dll）
为什么 phpinfo() 和 PhpStorm 控制台输出的扩展不一致
因为 Web SAPI（Apache/Nginx 加载的 PHP）和 CLI（命令行）默认用两套 php.ini 文件，而 PhpStorm 调用的是 CLI 版本 —— 所以你在 /etc/php/8.2/apache2/php.ini 里加了 Xdebug，对 PhpStorm 完全无效。
确认它实际加载哪个配置：
立即学习“PHP免费学习笔记（深入）”；
- 在 PhpStorm 内置 Terminal 里运行
php --ini，看输出的 “Loaded Configuration File” 路径（常见：/etc/php/8.2/cli/php.ini或C:\php\php.ini） - 编辑那个文件，追加 Xdebug 3 配置（注意版本匹配）：
zend_extension=xdebug<br>xdebug.mode=debug<br>xdebug.start_with_request=yes<br>xdebug.client_host=127.0.0.1<br>xdebug.client_port=9003
- 改完重启 PhpStorm，再在 Terminal 里跑
php -m | grep xdebug确认已加载
服务器路径映射配错，Xdebug 断点永远不触发
点了 “Start Listening for PHP Debug Connections”，断点也打了，但就是不中断 —— 最大概率是服务器映射没对上，Xdebug 发起的调试连接被 PhpStorm 当成未知请求丢弃了。
关键动作只有三步：
- Settings → Languages & Frameworks → PHP → Servers，点 “+” 添加新服务器
- Host 填
localhost，Port 填实际 Web 服务端口（如 Apache 默认80，Nginx 可能是8080） - 勾选
Use path mappings，把项目根目录（如D:\phpstudy_pro\WWW）映射到 Web 路径/；若项目在子目录（如http://localhost/myapp/），则映射为/myapp/
PHP 内置服务器无法调试？别硬扛
PhpStorm 自带的 “PHP Built-in Web Server” 仅支持运行，**不支持 Xdebug 调试** —— 因为它没走标准 CGI/SAPI 流程，Xdebug 模式无法注入。强行启用只会看到断点灰掉、监听无响应。
真要快速验证代码，又不想搭 Apache/Nginx：
- 用命令行启动：
php -S localhost:8000 -t ./public（注意指定文档根目录） - 然后在 PhpStorm 里配置一个普通 Server（Host
localhost，Port8000），映射好路径即可调试 - 或者直接用 phpStudy/XAMPP/Laragon 这类集成环境，稳定且省心
路径映射和 CLI php.ini 是两个最常被跳过的环节，漏一个，Xdebug 就静默失效。别信自动检测，每个路径都得亲手核对一遍。
