本质是PhpStorm终端未继承系统PATH，需在Settings→Tools→Terminal中显式配置Environment variables（如PATH=C:\php\;%PATH%）并重启终端标签页，同时在Languages & Frameworks→PHP中正确设置CLI Interpreter路径指向php.exe或php可执行文件。
PhpStorm 找不到 php 命令，本质是它启动的终端或内部 CLI 环境没继承到系统 PATH 里的 PHP 路径——哪怕你在 CMD 或 Terminal 里能直接敲 php -v 成功，PhpStorm 也不一定认。
Terminal 里 php 不识别：PATH 没透给 PhpStorm 的 shell
这是 Windows 和 macOS 上最常见的情况。PhpStorm 的内置 Terminal 默认不加载你 shell 的完整环境（比如 .zshrc 或 PATH 注册项），而是走精简初始化流程。
- Windows 下：进
Settings → Tools → Terminal，把Shell path改成cmd.exe或pwsh.exe（PowerShell），并在Environment variables里显式补上 PHP 目录，例如：PATH=C:\wamp64\bin\php\php8.2.0;%PATH% - macOS/Linux 下：同样进
Terminal设置，把Shell path改为完整路径，如/bin/zsh（别用sh）；如果仍不行，在Environment variables里加PATH=/opt/homebrew/bin:/usr/local/bin:$PATH - 验证方式：在 PhpStorm Terminal 里执行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认输出里真有 PHP 安装路径
运行/调试时提示 “No default interpreter”：PHP 解释器路径配置错误
这个报错和 Terminal 是否能跑 php 是两回事。它只说明 PhpStorm 的项目级解释器没设好，跟系统 PATH 几乎无关。
- 路径必须指向具体可执行文件，不是目录：Windows 是
C:\wamp64\bin\php\php8.2.0\php.exe，macOS 是/opt/homebrew/bin/php，Linux 是/usr/bin/php—— 别选错成php-cgi或php-fpm - 路径不能含中文、空格或符号链接（尤其 macOS 上通过 Homebrew 安装后，
which php返回的是 symlink，建议用readlink -f $(which php)取真实路径） - 如果用了 WAMP/MAMP/XAMPP，确保服务没占用 80 端口导致 PhpStorm 内置服务器冲突；但解释器本身不需要服务运行
Docker 远程解释器报 “php not found”：镜像里没装 PHP 或路径不对
PhpStorm 不是从运行中的容器找 php，而是从你指定的镜像里提取可执行文件路径。容器正在跑 ≠ 镜像自带 PHP。
立即学习“PHP免费学习笔记（深入）”；
- 先确认镜像是否真含 PHP：运行
docker run --rm -it your-php-image which php，看返回路径，比如/usr/local/bin/php - 在 PhpStorm 配置远程解释器时，“PHP executable path” 必须填这个绝对路径，不能留空或填
php - 如果你用的是官方
php:8.2-cli镜像，路径通常是/usr/local/bin/php；Laravel Sail 镜像可能是/usr/bin/php—— 每个镜像得实测 - 别用
FROM ubuntu自己构建却忘了RUN apt-get install -y php-cli，那镜像里确实没有php
改完还是不生效？重启和缓存常被忽略
PhpStorm 不会自动重载 PATH 或解释器配置，很多“修复无效”其实是没彻底刷新状态。
- 改完 Terminal 的
Environment variables或系统 PATH 后，必须关闭并重新打开 PhpStorm 的 Terminal 标签页（不是整个 IDE） - 改了解释器路径后，点右下角弹出的 “Reload project” 或手动进
File → Reload project from Disk - 极少数情况（尤其升级后），IDE 缓存损坏：菜单选
File → Invalidate Caches and Restart → Invalidate and Restart - macOS 上若用 Rosetta 运行 PhpStorm，而 PHP 是 Apple Silicon 原生编译的，可能架构不匹配，报 “bad CPU type” —— 此时需统一架构或换 M1 原生版 PhpStorm
