PhpStorm不读系统PATH，必须手动配置CLI解释器路径；Terminal和运行脚本使用两套独立路径体系，即使终端能执行php -v，Ctrl+Shift+F10仍会因未配置解释器而报错。
PhpStorm 不是找不到 PHP，而是根本没读你的系统 PATH —— 即便终端里 php -v 能跑，IDE 也照样报错「php is not recognized」。
为什么 Terminal 里能用，PhpStorm 却说找不到 php
PhpStorm 的内置 Terminal 默认不继承系统环境变量（尤其是 Windows 下的 PATH），哪怕你刚在「系统属性→环境变量」里加了 C:\php，它也可能完全无视。
- Windows 用户最常见原因：PhpStorm 启动时未加载更新后的 PATH，或用了旧版控制台（需勾选「使用旧版控制台」）
- macOS/Linux 用户注意：
which php返回的路径可能来自 shell 配置（如~/.zshrc），但 PhpStorm 启动时未必加载该配置文件 - 即使 Terminal 能识别
php，Ctrl+Shift+F10运行单文件仍会失败——因为运行脚本走的是 CLI Interpreter 配置，和 Terminal 是两套逻辑
CLI Interpreter 配置必须手动指定 php.exe 或 /usr/bin/php
PhpStorm 不自动扫描 PATH，必须显式告诉它 PHP 解释器在哪。否则连语法提示、Xdebug、Ctrl+Shift+F10 全部失效。
- 路径不能是别名或软链（如
/usr/local/bin/php指向/opt/homebrew/Cellar/php/8.3.8/bin/php），要填真实可执行路径 - Windows 下避免路径含中文、空格或括号（比如
C:\Program Files\php\php.exe就容易出问题，建议挪到C:\php\php.exe） - 用 WAMP/MAMP/XAMPP 的用户，别信「Auto-detect」——直接去
wamp64\bin\php\php8.2.0\php.exe这类路径里手动选 - 配完看右下角是否显示 PHP 版本号；没显示＝没生效，不是“看起来像对了”
Terminal 里 composer、git 也报错？改的是另一处设置
Terminal 的命令搜索路径和 CLI Interpreter 完全无关，它由 Settings → Tools → Terminal → Environment variables 控制。
立即学习“PHP免费学习笔记（深入）”；
- Windows 下：把系统 PATH 值完整复制过来，或直接设
PATH=C:\php;C:\phpstudy_pro\Extensions\composer;C:\Program Files\Git\cmd - macOS/Linux 下：别只写
PATH=/opt/homebrew/bin:$PATH，得确保该 shell 配置已生效——可先在系统终端执行source ~/.zshrc && echo $PATH，把输出结果整段粘过去 - 如果用了 Git Bash，
composer需要额外提供composer.bat或直接放composer可执行文件（不是composer.phar）
Docker 远程解释器提示「找不到容器中的 php」
错误不在 PhpStorm，而在你选错了目标：PhpStorm 要的是镜像里的 php 路径，不是正在运行的容器。
- 先确认镜像确实装了 PHP：
docker run --rm your-php-image which php，返回类似/usr/local/bin/php - 在 PhpStorm 配置远程解释器时，“PHP executable path” 必须填这个绝对路径，不能填
php或相对路径 - 如果用的是多阶段构建或精简镜像（如
php:alpine），检查是否漏装了php-cli包 - 别在「容器」里配解释器——得选「Docker Compose」或「Docker Image」，并指定镜像名 + PHP 路径
真正卡住人的从来不是“怎么加 PATH”，而是没意识到 PhpStorm 有三套独立的 PHP 路径体系：Terminal 的环境变量、CLI Interpreter 的硬编码路径、Docker 远程解释器的镜像内路径。改错地方，就永远在循环报错。
