PhpStorm 不读取系统 PATH，必须手动配置 CLI 解释器路径；否则 Ctrl+Shift+F10 运行报“No executable file found”，右下角显示“Invalid interpreter”。需在 Settings → Languages & Frameworks → PHP → CLI Interpreter 中点击齿轮→Add Local，手动选择 php.exe（Windows）或 /usr/bin/php（macOS/Linux），禁用 Auto-detect。
PhpStorm 不会自动读取系统 PATH 里的 php，哪怕你在终端里敲 php -v 能成功，IDE 里运行脚本、命令行工具、PHP Console 全都会报“找不到解释器”或“php 不是内部或外部命令”。必须手动指定路径。
为什么 PhpStorm 找不到你的 PHP 可执行文件
它不继承系统环境变量，也不信任“Auto-detect”——尤其当你用的是 XAMPP、WAMP、phpstudy_pro、Homebrew 或 phpbrew 管理多版本时，自动扫描大概率漏掉真实路径。错误现象包括：
- 按
Ctrl+Shift+F10运行单文件时弹出 “No executable file found” - 右下角 PHP 版本号不显示，或显示为 “Invalid interpreter”
- Terminal 里输
php报错，但系统 CMD/PowerShell 或 iTerm 里完全正常 - 配置了 Composer 或 Artisan 工具后，点“Run”提示 “Command not found”
必须在 Settings 里手动配 CLI Interpreter
路径不对，所有功能都卡死。操作要点：
- 打开
Settings → Languages & Frameworks → PHP → CLI Interpreter - 点右侧齿轮 →
Add Interpreter → Add Local - 别点“Auto-detect”，直接点文件夹图标，手动找：
– Windows：C:\php\php.exe（非 phpstudy_pro 的 alias 目录，而是实际 bin 下的 .exe）
– macOS：/usr/bin/php或/opt/homebrew/bin/php（用which php确认）
– Linux：/usr/bin/php或/usr/local/bin/php - 选完后看右下角是否立刻显示 PHP 版本号；没显示说明路径无效（比如指向了目录、.phar 文件，或权限不足）
Terminal 里 php/composer/git 还是不识别？单独配环境变量
PhpStorm 的 Terminal 是独立进程，PATH 不同步系统设置。需额外指定：
立即学习“PHP免费学习笔记（深入）”；
- 进入
Settings → Tools → Terminal - 在
Environment variables栏填入：PATH=/path/to/php:/path/to/composer:/usr/bin（Windows 用分号隔开） - Windows 用户注意：
composer.bat必须和php.exe在同一目录，且内容为：@php "%~dp0composer.phar" %* - 改完后重启 Terminal（关掉再开），输
echo $PATH（macOS/Linux）或echo %PATH%（Windows）确认路径已生效
Docker 远程解释器提示“找不到容器中的 php 可执行文件”
这不是路径写错了，是根本没让 PhpStorm 连到正确的镜像层：
- PHPStorm 需要从 镜像 启动容器来获取解释器，不是从正在运行的容器里找
- 确保你用的镜像里真装了 PHP：运行
docker run --rm your-image which php，输出应为/usr/local/bin/php类似路径 - 在解释器配置页选择该镜像后，
PHP executable path必须填绝对路径，如/usr/local/bin/php，不能写php - 如果用的是 Alpine 镜像，PHP 路径可能是
/usr/bin/php；Laravel Sail 镜像常用/usr/bin/php8.2—— 务必进容器验证
最常被忽略的一点：路径里含中文、空格、符号（如 C:\Program Files\），或者用了软链接但 PhpStorm 不解析。一律改用不含空格的纯英文路径，比如 C:\dev\php82\php.exe。配完不生效？先关掉 PhpStorm 再重开，缓存不刷新，绿色对勾不会出来。
