phpstorm调试cli脚本需三步：正确配置cli解释器路径（非依赖path）、确保xdebug 3在cli专用php.ini中启用（xdebug.mode=debug等），并开启phpstorm监听（端口9003）。
PHPStorm 能跑 CLI 脚本，但默认不自动识别你终端里能用的 php —— 配置错路径、漏 Xdebug、GUI 启动没继承 shell 环境，这三处占了 90% 的失败原因。
CLI 解释器路径选不对，php --version 在 Terminal 里能跑，PhpStorm 里却报 Cannot run program "php"
这不是 PhpStorm 有 bug，而是它压根没读你的 $PATH。尤其 macOS 用户用 Dock 图标启动时，~/.zshrc 完全不生效。
- 别信
php -v能跑就万事大吉；必须在 PhpStorm 自带的Terminal面板里执行which php（macOS/Linux）或where php（Windows），拿到真实绝对路径 - 路径示例：
/opt/homebrew/bin/php（Mac Homebrew）、C:\php\php.exe（Windows 便携版）、/usr/bin/php（Ubuntu 系统包） - 在 Settings → Languages & Frameworks → PHP → CLI Interpreter → Add → Local 中，用「…」按钮手动选中这个文件，不是输名字，也不是选目录
- Linux/macOS 下如果提示权限错误，补一句：
chmod +x /path/to/php
Run 'script.php' 成功，但 Debug 按钮点下去没反应
CLI 运行和 CLI 调试是两套独立配置：前者只依赖解释器路径，后者强依赖 Xdebug 是否加载进 CLI 的 php.ini，且端口、模式必须匹配 PhpStorm 监听设置。
- 先确认 CLI 实际加载哪个
php.ini：在 PhpStorm Terminal 里运行php --ini，看输出里的 “Loaded Configuration File” - Xdebug 3 必须写在这份 ini 里（不是 Apache/Nginx 的那个），且仅需三行关键配置：
zend_extension=xdebug、xdebug.mode=debug、xdebug.client_host=127.0.0.1（端口默认9003，别硬改成9000） - 扩展文件得真实存在：
extension_dir指向的目录下要有xdebug.so（Linux/macOS）或php_xdebug.dll（Windows） - PhpStorm 侧必须开启监听：菜单栏 Run → Start Listening for PHP Debug Connections（小电话图标亮起）
想用 php artisan 或 composer 命令，但提示 “command not found”
PhpStorm 不复用系统 PATH，哪怕你已把 composer 加进环境变量，GUI 启动时照样找不到。
- Settings → Languages & Frameworks → PHP → Composer → 勾选
Use composer executable - 填入
which composer的结果，例如：/opt/homebrew/bin/composer（Mac）、C:\Users\Name\scoop\shims\composer.bat（Windows Scoop） - 避免路径含空格：不要用
C:\Program Files\...，Scoop/Chocolatey 安装更稳 - 同理，artisan 等命令若依赖特定 PHP 版本，建议统一用已配好的 CLI 解释器来执行，而不是依赖全局 PATH
调试 CLI 脚本时断点不命中，或连接超时
常见于开发机和容器混用、防火墙拦截、Xdebug 配置未覆盖 CLI 场景。
- 检查
xdebug.mode是否包含debug（不是只有develop或off） - CLI 下 Xdebug 默认不自动触发，加参数强制启用：
php -dxdebug.mode=debug script.php - 若用 Docker，确保容器内
xdebug.client_host指向宿主机 IP（如172.17.0.1），而非127.0.0.1 - Windows 上杀毒软件或 Windows Defender 可能静默拦截
9003端口，临时禁用测试一次
最易被忽略的是：CLI 和 Web 请求走的是两套 php.ini，改完 Apache 的配置，CLI 依然不认 Xdebug——务必用 php --ini 确认当前上下文加载的是哪个文件。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
