PhpStorm必须手动关联本地或远程PHP可执行文件，否则代码提示、运行、调试全部失效；路径须指向php.exe或php文件本身（非目录），不能含中文或空格，且需确保CLI模式php.ini启用Xdebug并匹配PhpStorm监听端口9003。
PhpStorm 本身不带 PHP 解释器，必须手动关联本地或远程的 php 可执行文件，否则代码提示、运行、调试全部失效——这不是配置问题，是根本没“通电”。
PHP 解释器路径填错是最常见的启动失败原因
很多人在 Settings → Languages & Frameworks → PHP → Interpreter 里点“Add”，选中 php.exe（Windows）或 php（macOS/Linux），却忽略几个关键细节：
- 路径不能含中文或空格（例如
C:\Users\张三\php\php.exe或/Users/John Doe/php/bin/php会静默失败） - 必须指向可执行文件本身，不是目录（填
C:\php不行，得是C:\php\php.exe） - 若用 phpStudy/XAMPP/WAMP，路径通常是
D:\phpstudy_pro\Extensions\php\php8.2.12\php.exe或C:\xampp\php\php.exe，别直接选根目录 - 配置后看右下角是否显示 PHP 版本号；如果显示 “Failed to load interpreter info”，说明路径不可执行或权限被拦截（尤其 Windows Defender 有时会误杀）
Xdebug 3 配置必须匹配 PhpStorm 监听端口
启用断点调试前，php.ini 里的 Xdebug 设置和 PhpStorm 的监听设置必须严格对齐，否则“打上断点→刷新页面→毫无反应”：
- 确认已启用
zend_extension=xdebug（Windows 是.dll，Linux/macOS 是.so，路径要绝对正确） -
xdebug.mode=debug是必需项，仅xdebug.enable=1（Xdebug 2 写法）在新版里完全无效 -
xdebug.client_host=127.0.0.1和xdebug.client_port=9003必须与 PhpStorm 中Run → Start Listening for PHP Debug Connections的端口一致（默认 9003，不是旧版的 9000） - 浏览器需安装 Xdebug Helper 插件，并设为 “Debug” 模式；否则请求不会携带
XDEBUG_SESSION_START=PHPSTORM头
用内置 Web Server 时，URL 路径映射容易漏配
不想搭 Apache/Nginx？PhpStorm 自带的 PHP Built-in Web Server 很方便，但必须手动配好路径映射，否则 $_SERVER['DOCUMENT_ROOT'] 错乱、路由 404、静态资源 404 全部出现：
立即学习“PHP免费学习笔记（深入）”；
- 进
Settings → PHP → Servers，新增一个服务器，Host 填localhost，Port 填63342（默认）或自定义端口 - 务必勾选
Use path mappings - 左边填项目根目录（如
D:\myproject），右边填/（不是/myproject） - 如果项目入口是
public/index.php，则左边填D:\myproject\public，右边仍填/；否则require '../vendor/autoload.php'会报错
最常被跳过的其实是 php.ini 文件位置：PhpStorm 读取的是 CLI 模式下 php --ini 显示的配置文件，不是 Apache 模块用的那个。改完 php.ini 一定要重启 PhpStorm，否则 Xdebug 设置永远不生效。
