PhpStorm提示“PHP interpreter not found”说明其不读系统PATH，需手动指定绝对路径：Windows填C:\php\php.exe，macOS/Linux用which php查真实路径（非软链接），并确保PHP为TS版本；若“Failed to load PHP version”，则版本类型或路径错误。
php -v 能运行，但 PhpStorm 里提示“PHP interpreter not found”
说明系统 PATH 里的 php 可执行文件没被 PhpStorm 正确识别——它不读系统环境变量，只认你手动指定的绝对路径。
- Windows 下必须指向具体文件，比如
C:\php\php.exe，不能只填php或C:\php - macOS/Linux 用户注意：用
which php查到的是软链接（如/usr/local/bin/php），但 PhpStorm 有时无法解析软链接，建议直接填真实路径，比如/usr/local/Cellar/php/8.2.12/bin/php - 如果选中
php.exe后提示 “Failed to load PHP version”，大概率是 PHP 安装包类型不匹配：Windows 上务必选 TS（Thread Safe）版本，NTS 版本在 Apache 模式下可用，但 CLI 和 PhpStorm 不认
配置完解释器，phpinfo() 能跑，但断点不生效
Xdebug 没真正挂载进当前 PHP 实例，或者 PhpStorm 没监听对端口。
- 先确认
php -m | grep xdebug（Linux/macOS）或php -m（Windows）输出里有xdebug—— 没有就说明扩展没加载 - 检查
php.ini中是否同时存在zend_extension=...xdebug.so（Linux/macOS）或zend_extension=php_xdebug.dll（Windows），且路径正确；Xdebug 3 要求用zend_extension，不是extension - PhpStorm 默认监听
9003端口，但你的php.ini里如果还写着xdebug.client_port=9000，就会连不上；统一改成9003，并确保xdebug.mode=debug和xdebug.start_with_request=yes已启用 - 别忘了在 PhpStorm 里手动点击
Run → Start Listening for PHP Debug Connections（那个绿色电话图标），否则它根本不会接收调试请求
用 phpStudy/XAMPP 集成环境时，项目路径映射总出错
不是解释器路径问题，而是 PhpStorm 的服务器配置和实际 Web 根目录没对齐。
- phpStudy 默认 Web 根目录是
D:\phpstudy_pro\WWW（Windows）或/Applications/phpstudy_pro/htdocs（macOS），你必须把 PhpStorm 项目打开在这个目录下，或至少让项目根目录与之完全一致 - Settings → PHP → Servers 里添加的服务器 Host 填
localhost，Port 填 phpStudy 实际监听的端口（通常是 80 或 8080），然后勾选Use path mappings，把本地项目路径（如D:\phpstudy_pro\WWW）映射到/—— 这一步漏掉，浏览器访问http://localhost/test.php就会 404 - 如果你在 PhpStorm 里右键 Run ‘test.php’，它走的是内置 CLI 模式，不经过 Apache/Nginx；要测试 Web 行为，必须用浏览器访问，而不是靠 Run 按钮
为什么改了 php.ini，重启 phpStudy 后 phpinfo() 里还是看不到 Xdebug？
你可能编辑了错误的 php.ini 文件。
立即学习“PHP免费学习笔记（深入）”；
- phpStudy、XAMPP、MAMP 都自带多套 PHP 版本，每套都有独立的
php.ini；在phpinfo()页面顶部找 “Loaded Configuration File” 这一行，它显示的才是当前生效的 ini 路径，别凭印象去改别的位置 - Windows 下常见陷阱：phpStudy 的 PHP 目录结构是
D:\phpstudy_pro\Extensions\php\php8.2nts\（nts）或php8.2ts\（ts），而php.ini在对应子目录里，不是在phpstudy_pro根目录下 - 改完
php.ini必须重启 phpStudy 的 PHP 服务（不只是 Apache/Nginx），否则修改不生效；只点“重启”按钮不够，有时得先“停止”再“启动”
