PhpStorm 必须手动配置本地 PHP 解释器路径才能运行，否则报“PHP interpreter is not configured”；需用 php -v 和 which php/where php 确认 CLI 可执行文件路径，选对 php.exe（非 php-cgi.exe 等），并确保 php.ini 中 xdebug.mode=debug 且 client_port 与 PhpStorm 的 Debug port（默认9003）一致，同时配置 Servers 映射路径以支持浏览器访问和 Xdebug 调试。
PhpStorm 本身不带 PHP 解释器，直接打开 PHP 文件写代码、点运行会报错——PHP interpreter is not configured。必须先告诉它“你本地的 php.exe 或 php 在哪”，后续的语法检查、php -l 验证、Xdebug 断点、Composer 自动识别才能生效。
怎么找对 php.exe 路径？别用“随便选一个”
常见错误是选了错误的可执行文件：比如选了 php-cgi.exe（只用于 CGI 模式）、php-win.exe（无控制台输出），或者选了 phpStudy/XAMPP 里某个旧版本的 php.exe（导致 Xdebug 加载失败）。
- 优先用
php -v命令确认当前终端调用的是哪个 PHP：Windows 下在 CMD/PowerShell 运行，macOS/Linux 在 Terminal 执行 - 路径要指向真正的 CLI 可执行文件：
C:\php\php.exe、/usr/bin/php、D:\phpstudy_pro\Extensions\php\php8.2.12\php.exe - 如果用了 phpStudy，别去根目录翻，直接进
Extensions\php\下找带版本号的子文件夹，里面才有正确的php.exe - 选完后 PhpStorm 会显示 PHP 版本和已启用的扩展列表，重点看
xdebug是否出现在其中（若没出现，说明路径或 php.ini 配置有问题）
php.ini 里 Xdebug 配置必须匹配 PhpStorm 监听端口
即使 php -m | grep xdebug 能看到模块，但 PhpStorm 无法连接调试，大概率是 php.ini 中的通信参数和 IDE 监听设置不一致。
- Xdebug 3+ 必须用
xdebug.mode=debug，不是zend_extension="xdebug.so"单独一行就完事 -
xdebug.client_host应为127.0.0.1（非localhost，某些系统 DNS 解析慢会导致超时） -
xdebug.client_port默认是9003，而 PhpStorm 的 Debug 配置默认监听端口也得设成9003（Settings → PHP → Debug → Xdebug → Debug port） - 如果改过端口，务必同步改两处：php.ini 和 PhpStorm 设置，漏一不可
用 phpStudy 时，“服务器配置”不能跳过
只配了解释器，Run → Run 'xxx.php' 仍可能报 404 或空白页——因为 PhpStorm 默认用内置服务器（port 63342），而 phpStudy 是走 Apache/Nginx 的 http://localhost/。想浏览器直接访问、配合 Xdebug Helper 插件触发调试，必须补这步。
立即学习“PHP免费学习笔记（深入）”；
- Settings → PHP → Servers → 点 + 添加：Name 填
LocalApache，Host 填localhost，Port 填80（或 phpStudy 面板里显示的实际端口） - 勾选
Use path mappings，把项目根目录（如D:\phpstudy_pro\WWW\myproject）映射到/；如果项目在子目录，就映射到/myproject/ - 之后右键 PHP 文件 →
Debug 'xxx.php'，浏览器会自动打开http://localhost/xxx.php?XDEBUG_SESSION_START=PHPSTORM，触发断点
最容易被忽略的是：phpStudy 启动后，Apache/Nginx 和 MySQL 是两个独立服务，有时只开了 Apache 却忘了开 MySQL；或者 Windows 防火墙拦截了 9003 端口；又或者 PhpStorm 的 “Start Listening for PHP Debug Connections” 按钮没点——这些都会让断点静默失效，看起来像“配置好了但就是不进”。
