PhpStorm必须手动配置本地PHP解释器路径，否则代码提示、语法检查、运行和调试全部失效；需通过php -v验证终端可用性，用which php或where php获取绝对路径，在Settings→PHP→Interpreter中准确填写，避免填错类型、路径含空格或中文，并同步设置匹配的Language Level。
PhpStorm 本身不带 PHP 解释器，必须手动指定一个可用的 php 可执行文件，否则代码提示、语法检查、运行和调试全都会失效。
确认本地 php 已就绪且路径正确
在终端执行 php -v 能输出版本号，是配置成功的前提。常见失败点包括：
- PATH 未包含 PHP 安装目录（如 Windows 的
C:\php，macOS 的/opt/homebrew/bin） - 下载了 NTS（非线程安全）版 PHP，但 Web 服务器（如 Apache）要求 TS 版本
- 路径含中文或空格（如
C:\Program Files\php\php.exe），PhpStorm 会静默拒绝 - 使用了软链接但权限不足，
ls -l /usr/bin/php看是否指向真实可执行文件
推荐做法：用 which php（macOS/Linux）或 where php（Windows）获取绝对路径，直接粘贴进 PhpStorm 设置框。
添加解释器时选错类型或填错路径
在 Settings → Languages & Frameworks → PHP → Interpreter 中，点击齿轮 → Add Interpreter → Add Local 后，关键操作只有一步：在 PHP executable 输入框里填入真实路径，比如：
立即学习“PHP免费学习笔记（深入）”；
- macOS Homebrew 安装：
/opt/homebrew/bin/php - Linux 手动编译：
/usr/local/bin/php - Windows XAMPP：
C:\xampp\php\php.exe - Windows phpStudy：
D:\phpstudy_pro\Extensions\php\php8.2.0\php.exe
⚠️ 不要填 /bin/sh -c "php" 或 php（不带路径），也不要点“Browse”后误选 php.ini 或文件夹。
语言级别不匹配导致新语法报错
即使 php -v 显示是 PHP 8.2，如果 PhpStorm 的 Language Level 还设在 PHP 7.4，match、enum、readonly 就会标红报错。
- 设置位置：同在
PHP设置页，下方有Language level下拉菜单 - 必须与你实际使用的 PHP 版本一致（不是与 IDE 版本一致）
- 项目级设置优先于全局设置，切换项目时记得检查是否被覆盖
- 改完后建议点
File → Invalidate Caches and Restart刷新解析器状态
Docker 环境下误配本地解释器
如果你用 docker-compose.yml 管理 PHP 服务（如 services: app:），不该配本地 php，而应走远程解释器路径：
- 添加解释器时选
Add Interpreter → Remote Interpreter → Docker Compose -
Service name必须填docker-compose.yml中services下的键名（如app），不是容器名或镜像名 -
Interpreter path固定填/usr/bin/php（Alpine/Debian 都适用），别写成/usr/local/bin/php或尝试自动探测 - 首次配置会自动启动容器并挂载项目目录；若卡住，先
docker-compose up -d app手动启一下
混合使用本地 CLI 和容器内运行环境时，最容易忽略的是 Composer 命令行为差异——本地 composer install 写的依赖路径可能和容器内不一致，建议所有 CLI 操作都走 Docker Compose 解释器。
