PHPStan 在 PhpStorm 中不标红需依次检查：安装 JetBrains 官方插件并重启；配置正确的 vendor/bin/phpstan 路径；编写合法 phpstan.neon 明确声明 paths；理解其仅保存后扫描当前文件，非实时检查。
PHPStan 在 PhpStorm 里不标红？先确认插件装对了
PHPStorm 本身不带 PHPStan 支持，必须手动装 JetBrains 官方维护的 PHPStan Support 插件——不是随便一个叫“PHP Static Analyzer”的第三方插件都能用。
- 打开
Settings → Plugins，搜phpstan，只认准作者是JetBrains、图标为蓝白盾牌的那个 - 装错插件会导致
Settings → Languages & Frameworks → PHP → PHPStan根本不出现配置项 - 装完必须重启 PhpStorm，否则设置面板不会刷新，右键菜单也没有
Run PHPStan - 如果之前装过其他 PHPStan 插件，建议先全部卸载再重装官方版
配置路径失败：vendor/bin/phpstan 找不到或验证报错
PHPStan 不是内置工具，得靠 Composer 安装到本地项目里，IDE 只是调用它。路径配错，等于让 PhpStorm 去敲一扇不存在的门。
- 确保已在项目根目录执行过：
composer require --dev phpstan/phpstan - 路径填的是可执行文件真实位置：
vendor/bin/phpstan（Linux/macOS）或vendor\bin\phpstan.bat（Windows） - 别填
phpstan.phar或全局安装路径——CI 和协作环境容易版本漂移，本地项目依赖才稳定 - 点
Validate报错？检查文件是否存在、是否可执行，以及当前项目 PHP 解释器版本是否 ≥ 7.1（PHPStan v1.x 要求 ≥ 7.4）
Class not found 错误频出？不是代码问题，是没告诉 PHPStan 上哪找类
PHPStan 不走 Composer autoloader，它靠 AST 解析源码，所以 autoload 配置再全也没用——它只看你显式声明的扫描路径。
- 在项目根目录创建
phpstan.neon，至少写清paths：
parameters:
level: 5
paths:
- src
- app
- lib
- packages/*/srcapp/Models、app/Services 这些目录必须列进 paths，不能指望它自动发现App\Helpers → helpers/），PHPStan 会跳过，老老实实按真实路径写vendor、tests/bootstrap.php 等非源码路径，避免干扰为什么改了代码不自动检查？PHPStan 在 PhpStorm 里不实时运行
它不像 ESLint 那样监听文件变化，也不在键入时标红。它的触发时机很明确：仅在你保存文件后，且仅扫描当前文件（或你右键选中的范围）。
立即学习“PHP免费学习笔记（深入）”；
- 没有“后台常驻进程”，所以不会占用内存持续分析
- 想扫整个项目？右键项目根目录 →
Run PHPStan，或终端跑：vendor/bin/phpstan analyse - 保存即扫是默认行为，但前提是插件已启用、路径已验证、
phpstan.neon语法合法（YAML 缩进错误会导致静默失效） - 如果保存后毫无反应，先检查
phpstan.neon是否有拼写错误，比如把parameters写成paramters
最常被忽略的一点：PHPStan 的 level 是渐进式的，从 0 到 9，每级新增大量规则。新项目直接设 level: 8 很可能扫出上百个历史问题；老项目建议先用 --generate-baseline 生成基线文件，再逐步收紧——否则配置刚搞好，就被一堆报错劝退了。
