PHP解释器配置失败90%因路径或权限问题；远程标红补全失效主因是扩展未启用stub或include path未映射；Xdebug断点不触发关键在调试参数、监听状态及路径映射精准性。
本地 PHP 解释器配不成功，90% 是路径或权限问题；远程解释器连得上但标红、补全失效，基本是扩展没加载或 include path 没映射。
本地 php.exe 找不到或版本不识别
常见现象：点选 php.exe 后 PhpStorm 提示“Invalid PHP executable”或版本显示为“unknown”。这不是 PhpStorm 的 bug，而是它在尝试执行 php --version 时失败了。
- 确认你选的是 CLI 版本的
php.exe（Windows）或php（macOS/Linux），不是 Apache 模块（php7apache2_4.dll这类） - 如果解压版 PHP 没加环境变量，
php -v在命令行也报错——先在终端里手动验证这一步再进 PhpStorm - Windows 用户注意路径中不能含中文或空格；若用 phpStudy/XAMPP，路径类似
D:\phpstudy_pro\Extensions\php\php8.2nts\php.exe，nts表示非线程安全，适用于 Apache 模式 - macOS/Linux 下若用 Homebrew 安装，实际路径常是
/opt/homebrew/bin/php或/usr/local/bin/php，别直接选/usr/bin/php（系统自带，往往没装扩展）
远程解释器能连上但 new Redis() 一直标红
PhpStorm 读取远程 php --ini 和 php -v 只能拿到基础信息，不会自动加载扩展的代码提示（stubs）。它不知道你启用了 redis，除非你告诉它。
- 配置完 SSH/Docker 类型解释器后，在 PHP 设置页点击
Show all files→ 勾选redis、pdo_mysql等对应扩展（不是勾 php.ini 里的 extension=...，是勾 PhpStorm 自带的 stubs） - 如果扩展是手动编译安装（比如
/usr/local/lib/php/extensions/no-debug-non-zts-20220829/redis.so），PhpStorm 不会扫描 so 文件，必须手动启用 stubs - Docker 场景下，若用
docker exec -it app php -v能输出版本，但在 PhpStorm 里选 SSH 类型填容器内路径（如/usr/local/bin/php），会失败——因为 PhpStorm 是从宿主机 SSH 连过去执行，而该路径只存在于容器里。应选Docker或Docker Compose类型，并指定服务名
PHP 解释器配好了，但 Run ‘index.php’ 报错 “No web server is configured”
这是混淆了 CLI 运行和 Web 运行。配好解释器只是让 PhpStorm 能执行 PHP 脚本，不代表它知道怎么启动 Web 服务。
立即学习“PHP免费学习笔记（深入）”；
- 想直接运行单个 PHP 文件（无 Web 环境），右键 →
Run 'index.php'即可，依赖的是 CLI 解释器，不需要服务器配置 - 想通过浏览器访问
http://localhost/index.php，必须额外配置Servers（Settings → PHP → Servers），填 host/port，并设置Use path mappings映射项目根目录到 Web 根目录（如C:\xampp\htdocs→/） - 内置 PHP Server（
php -S）可用，但仅限简单测试：右键文件 →Run 'index.php' (PHP Built-in Web Server)，它会自动起一个临时服务，端口随机，不适用于依赖 .htaccess 或 rewrite 的项目
Xdebug 配置生效但断点不触发
解释器页面显示 Xdebug 已加载 ≠ 调试通道打通。关键在请求是否携带调试参数、IDE 是否监听、路径是否对齐。
- 确保
xdebug.mode=debug且xdebug.start_with_request=trigger（推荐），然后 URL 加?XDEBUG_SESSION_START=PHPSTORM；或者设为yes并配合浏览器插件（如 Xdebug Helper） - PhpStorm 必须点击电话图标启用
Start Listening for PHP Debug Connections，状态为绿色才表示监听中 - 路径映射（path mappings）必须精确：远程服务器上的
/var/www/html要对应本地项目根目录，差一个子目录都会导致断点失效 - Windows + WSL 场景下，
xdebug.client_host不能写127.0.0.1，得用 Windows 主机 IP（如192.168.100.1），因为 WSL 的 127.0.0.1 指向自己，不是 Windows
最常被跳过的环节是：远程解释器配置完后没点 Show all files 勾扩展，以及本地服务器映射漏掉 Use path mappings。这两步不做，补全和调试就只剩半条命。
