PHPStan 在 PhpStorm 中需通过 Settings → Tools → External Tools 配置，或 2022.3+ 版本原生支持的 PHP → PHPStan 检查启用；关键要设对 phpstan.neon 路径、--error-format=phpstorm 参数及 autoload_files。
PHPStan 在 PhpStorm 中的配置路径在哪
PHPStorm 本身不内置 PHPStan，必须通过外部工具（External Tools）或插件方式接入。最稳定的方式是用 PHPStan CLI 命令行工具 + PhpStorm 的 External Tools 配置，而不是依赖第三方插件（如 PHPStan Plugin），因为后者常滞后于 PHPStan 主版本，且对自定义配置（如 phpstan.neon）支持不稳定。
配置入口在：Settings → Tools → External Tools，点击加号添加新工具。
如何让 PHPStan 扫描当前文件并高亮错误
关键不是“运行一次”，而是让它像语法检查一样实时反馈。这需要两步：一是配置 External Tool 触发命令，二是启用「Run inspection tools after save」并绑定到 PHPStan。
- External Tool 的
Program填phpstan（确保已全局安装，或写绝对路径如/path/to/vendor/bin/phpstan） -
Arguments推荐用：analyse --no-progress --error-format=phpstorm --configuration=phpstan.neon --level=8 "$FilePath$" -
Working directory设为$ProjectFileDir$，确保能读到phpstan.neon - 勾选
Show console when a tool is run，方便调试路径或配置错误
注意：--error-format=phpstorm 是必须项，否则 PhpStorm 无法解析错误位置；"$FilePath$" 表示只分析当前打开文件，避免全项目扫描拖慢响应。
立即学习“PHP免费学习笔记（深入）”；
为什么 phpstan.neon 配置不生效
常见原因是路径未被识别或格式错误。PHPStan 默认只认项目根目录下的 phpstan.neon，如果放错位置（比如子目录里），或者用了 phpstan.neon.dist 但没加 --configuration 参数，就会退回到默认规则（level 0）。
- 确认
phpstan.neon存在于$ProjectFileDir$（即 PhpStorm 打开的项目根目录） - 文件开头不能有 BOM，YAML 缩进必须用空格（不能用 Tab）
- 若使用 Composer 安装，建议用
vendor/bin/phpstan而非全局phpstan，避免 PHP 版本或扩展差异导致dynamicReturnTypeExtensions类功能异常 - 常见报错
Class XXX was not found多因 autoloader 未加载，需在phpstan.neon中显式配置：autoload_files: [vendor/autoload.php]
怎么把 PHPStan 错误变成编辑器内联提示（而非仅控制台输出）
靠 External Tools 本身做不到实时内联提示——它只是运行命令并展示结果。真要获得类似 IDE 内置检查的体验，唯一可靠路径是启用 PhpStorm 的 PHP → PHPStan 检查（2022.3+ 版本原生支持）：
- 开启：
Settings → Editor → Inspections → PHP → PHPStan，勾选启用 - 填入
PHPStan binary path（例如vendor/bin/phpstan） - 指定
Configuration file路径（必须是绝对路径，可用$ProjectFileDir$/phpstan.neon） - 设置
Level（推荐 7 或 8，Level 9 对 Laravel/Doctrine 等框架易误报）
这个检查会随编辑自动触发，错误直接标黄线、悬停显示，且能跳转到问题行。但前提是你的 phpstan.neon 里没禁用 reportUnmatchedIgnoredErrors: false，否则部分忽略规则会导致整个文件跳过分析。
最易被忽略的是：PHPStan 的 level 设置和 phpstan.neon 中的 includes: 引入的扩展配置，两者叠加后实际检测强度可能远超预期——改一个 level 数字，有时会让 CI 直接失败，本地却没察觉，因为 PhpStorm 的 inspection 默认只跑当前文件，而 CI 是全量扫描。
