PhpStorm 运行 Artisan/Drush 报“php 不是内部或外部命令”主因是 CLI 解释器路径未正确配置：需设绝对路径（如 C:\php\php.exe 或 /opt/homebrew/bin/php），避开中文、空格、软链；且 CLI 解释器与 Terminal Shell 路径需分别配置并验证。
PHP CLI 解释器路径没填对
PhpStorm 运行命令行脚本或 Artisan/Drush 时提示 php 不是内部或外部命令，最常见原因是它根本没找到 PHP 可执行文件。这不是 PhpStorm 的 bug，而是你没告诉它 PHP 在哪。
检查路径是否满足以下条件：
-
php.exe（Windows）或php（macOS/Linux）必须是可执行文件，不能是快捷方式或别名 - 路径中不能含中文、空格或特殊符号（比如
C:\Program Files\php\php.exe就大概率失败） - 推荐用绝对路径，例如 Windows 下选
C:\php\php.exe，macOS 下用/opt/homebrew/bin/php而非which php输出的软链 - 在终端里手动运行
php -v成功，不代表 PhpStorm 能继承该环境——它默认不读系统 shell 的 PATH
终端和 CLI 解释器用了两套 PHP 环境
你可能在终端里能跑 php -v，但 PhpStorm 的「运行命令」或「调试」仍报错。这是因为 PhpStorm 分开了两个配置点：
-
CLI 解释器：用于运行脚本、Artisan、Drush，路径在
Settings → PHP → CLI Interpreter -
终端（Terminal）Shell：用于底部 Terminal 标签页，路径在
Settings → Tools → Terminal → Shell path
两者可以不同。如果只配了 CLI 解释器但 Terminal 里还是报错，说明 Terminal 没走你配的 PHP；反之，如果 Terminal 能跑但 Artisan 报错，则是 CLI 解释器没设对。务必分开确认。
立即学习“PHP免费学习笔记（深入）”；
PHPStorm 启动时没加载系统 PATH
即使你在系统环境变量里加了 PHP 路径，从桌面图标启动 PhpStorm 时，它往往不会继承 shell 的完整 PATH（尤其是 macOS 和 Linux）。结果就是：php -v 在 iTerm 或 Terminal.app 里能跑，但在 PhpStorm 内置 Terminal 里不行。
- Windows：通常不受影响，PATH 继承较稳定
- macOS：推荐用
open -a PhpStorm从终端启动，或在~/.zshrc里确保 PATH 设置在所有会话生效 - Linux：检查桌面环境是否使用 systemd user session，有时需在
~/.profile而非~/.bashrc中导出 PATH - 临时验证法：在 PhpStorm Terminal 里执行
echo $PATH，看输出是否含你的 PHP 目录
Artisan/Drush 命令识别失败但 PHP 本身正常
CLI 解释器测试通过（显示绿色对勾），php -v 也成功，但运行 artisan list 仍报错，常见原因有：
- 项目根目录没设对：PhpStorm 需要知道
artisan文件在哪，右键项目根目录 →Mark Directory as → Sources Root - Artisan 权限问题（Linux/macOS）：
chmod +x artisan，否则即使 PHP 可执行，shell 也无法调用它 - Artisan 头部 shebang 错误：打开
artisan文件第一行，应为#!/usr/bin/env php，不是硬编码路径如#!/usr/bin/php - PHP 版本不兼容：比如 Laravel 11 要求 PHP 8.2+，而你 CLI 解释器配的是 PHP 7.4，此时报错可能不提示版本问题，只说 command not found 或 exit code 1
