PhpStorm本身不运行PHP，仅调用本地CLI解释器；需手动配置which php/where php获取的绝对路径，确保CLI php.ini启用Xdebug（xdebug.mode=debug等），并精确设置服务器路径映射。
PhpStorm 本身不运行 PHP，它只调用你系统里已安装的 PHP 解释器。配置失败的绝大多数情况，不是 PhpStorm 有问题，而是它根本没找到你终端里能跑起来的那个 php。
为什么 PhpStorm 找不到 php 命令
GUI 启动的 PhpStorm（比如 macOS 从 Dock 点开、Windows 双击快捷方式）默认不加载 shell 的 PATH 环境变量。你在终端里能敲 php -v 成功，不代表 PhpStorm 能看见它。
- 先在终端执行
which php（macOS/Linux）或where php（Windows），拿到绝对路径，例如/usr/bin/php或C:\php\php.exe - 别信 Settings → PHP → Interpreter 页面里那个“自动检测”按钮——它大概率扫不到
- 必须手动点击齿轮 → Add Interpreter → Local → 浏览并选中上面拿到的完整路径
- 选完后右下角要显示类似 “PHP 8.2.12 (cli)” 才算成功；没显示就说明路径错、权限不足，或该二进制缺依赖（如 Windows 缺
msvcr120.dll）
CLI 和 Web 的 php.ini 是两套，Xdebug 必须配对 CLI
PhpStorm 默认调用的是 CLI 版本的 PHP，所以你在 Apache/Nginx 的 php.ini 里加了 Xdebug，对 PhpStorm 完全无效。
- 在 PhpStorm 内置 Terminal 里运行
php --ini，确认它实际加载的是哪个php.ini（常见路径：/etc/php/8.2/cli/php.ini或C:\php\php.ini） - 编辑那个 CLI 对应的
php.ini，追加 Xdebug 3 配置：
zend_extension=xdebug xdebug.mode=debug xdebug.start_with_request=yes xdebug.client_host=127.0.0.1 xdebug.client_port=9003
- 改完重启 PhpStorm，再在 Terminal 里运行
php -m | grep xdebug确认扩展已加载
服务器路径映射配错，断点永远不触发
点了 “Start Listening for PHP Debug Connections”，断点也打了，但就是不中断——90% 是服务器映射没对上。
立即学习“PHP免费学习笔记（深入）”；
- 进 Settings → PHP → Servers，点 + 添加服务器
- Name 填项目名，Host 填
localhost，Port 填你 Web 服务实际端口（如 8080） - 务必勾选
Use path mappings，然后把你的项目根目录（如/home/user/myapp）映射到/（或你 Web 根路径，如/var/www/html） - 这个映射必须和 Xdebug 发起请求时的文件路径完全一致，否则 PhpStorm 直接丢弃调试连接
最常被忽略的点：Xdebug 是否真在 CLI 模式下启用——php -m | grep xdebug 没输出，其他所有配置都是白搭；路径映射不是“看着差不多就行”，必须是精确的、可双向解析的绝对路径。
