PHP解释器路径必须手动指定，不能依赖系统PATH；需在终端运行which php或where php获取绝对路径，再于PhpStorm中Settings→PHP→Interpreter→“+”→“Local”手动选择该php文件，确保右下角显示PHP版本号，否则为路径错误、权限不足或依赖缺失。
PHP解释器路径必须手动指定，不能依赖系统PATH
PhpStorm 启动时不会自动继承终端的 PATH 环境变量，尤其是 macOS 用 Dock 启动、Windows 用快捷方式启动时，GUI 进程压根没加载 shell 配置。直接点 Settings → PHP → Interpreter → “+” → “Local” → 自动检测，大概率失败。
正确做法是先在终端运行 which php（macOS/Linux）或 where php（Windows），拿到绝对路径，例如 /opt/homebrew/bin/php 或 C:\php\php.exe，再手动浏览选择该文件。选完后右下角必须显示类似 PHP 8.2.12 (cli) 的字样——没显示就是路径错、权限不足，或缺失运行时依赖（如 Windows 缺 msvcr120.dll）。
- 别信“自动检测”，它只对极简安装有效
- CLI 和 Web SAPI 的
php.ini是两套配置，PhpStorm 默认用 CLI 版本 - 在 PhpStorm 内置 Terminal 中执行
php --ini，确认它实际加载的是哪个php.ini
Xdebug 必须配 CLI 版 php.ini，不是 Apache/Nginx 的那个
很多人在 /etc/php/8.2/apache2/php.ini 里加了 xdebug，结果 PhpStorm 断点完全不触发——因为 PhpStorm 调用的是 CLI 模式下的 PHP，加载的是 /etc/php/8.2/cli/php.ini（Linux/macOS）或 C:\php\php.ini（Windows）。
改完后务必在 PhpStorm Terminal 中运行 php -m | grep xdebug，确认扩展已加载；再检查 php -i | grep "xdebug.mode" 是否输出 debug。
立即学习“PHP免费学习笔记（深入）”；
- Xdebug 3 配置必须包含
xdebug.mode=debug和xdebug.start_with_request=yes - 端口默认是
9003，PHPStorm 的 Debug 设置里要严格匹配 -
xdebug.client_host填127.0.0.1，别用localhost（某些系统 DNS 解析慢会导致超时）
服务器路径映射错一个字符，Xdebug 就永远连不上
点了 “Start Listening for PHP Debug Connections”，断点也打了，但请求一发就消失——90% 是因为 Servers 配置里的路径映射没对上。Xdebug 发起的调试连接被 PhpStorm 当成未知请求丢弃，根本不会触发断点。
进 Settings → Languages & Frameworks → PHP → Servers，新建条目：Host 填 localhost，Port 填你 Web 服务的实际端口（如 8080），勾选 Use path mappings，然后把本地项目根目录（如 /Users/me/project）精确映射到 Web 服务器看到的路径（如 /var/www/html/project）。
- 映射路径必须全路径、大小写敏感、结尾不带斜杠
- 如果用 Docker 或 Valet，映射路径要和容器内或 Valet 的 DocumentRoot 一致
- 测试方法：在浏览器访问
http://localhost:8080/test.php，同时看 PhpStorm 底部状态栏是否出现 “Debug connection established”
插件选多了反而拖慢索引，按技术栈精配才有效
装一堆插件不等于高效，反而可能让 PhpStorm 启动变慢、索引卡死。真正有用的组合取决于你实际用的框架和工具链。
比如 Laravel 项目，Laravel Idea + PHP Annotations 就够了；Doctrine/Symfony 项目优先配 PHP Toolbox + Symfony Plugin；纯 API 项目或微服务，PHP Intelephense 替代原生引擎能显著提升跳转准确率。
-
PHP Intelephense开启后建议关掉 PhpStorm 原生索引（Settings → PHP → PHP Language Level → 取消勾选 “Enable PHP language level detection”） -
Psalm Plugin和PHPStan Plugin二选一即可，同时开会重复扫描、拖慢编辑器响应 - Docker 插件只在项目真实用
docker-compose.yml时才需要，否则纯属冗余
