PHPStan 在 PhpStorm 中不自动运行需安装 JetBrains 官方插件；配置文件路径须手动指定且语法合法；它不实时标红，仅保存时扫描；Class not found 问题多因 autoload 未正确声明。
PHPStan 在 PhpStorm 中不自动运行？检查是否装了正确插件
phpstorm 本身不内置 phpstan 支持，必须手动安装 phpstan 插件（jetbrains 官方维护），不是随便一个“php linter”或“static analyzer”都能替代。插件市场里搜 phpstan，认准作者是 jetbrains，图标是蓝白盾牌。装错插件会导致配置项根本不出现在设置里。
常见错误现象：Settings → Languages & Frameworks → PHP → PHPStan 路径压根不存在；或者右键菜单没有 Run PHPStan 选项。
- 卸载所有非 JetBrains 官方的 PHPStan 相关插件
- 重启 PhpStorm 后再进插件市场重新安装
PHPStan - 装完不重启，设置面板不会刷新，插件也不生效
PHPStan 找不到 phpstan.neon 配置文件？路径和加载顺序很关键
PHPStorm 默认只在项目根目录找 phpstan.neon，如果配置文件放在子目录（比如 tools/phpstan/phpstan.neon），它不会自动发现，也不会报错，而是静默回退到默认规则（相当于没配）。
使用场景：团队用统一配置、或项目中 PHPStan 和 Psalm 共存，配置需隔离。
- 在
Settings → Languages & Frameworks → PHP → PHPStan中，手动填写Configuration file的绝对路径或相对路径（推荐用$ProjectFileDir$/tools/phpstan/phpstan.neon） - 路径中不能有中文、空格或符号链接，否则 PHPStan 进程启动失败，但 PhpStorm 只显示 “PHPStan exited with code 1”，不提示具体原因
-
phpstan.neon必须语法合法，哪怕只是空文件也要有parameters:根节点，否则报Invalid configuration file
为什么改了代码，PHPStan 不实时标红？它不是 IDE 内置检查器
PHPStan 是外部 CLI 工具，PHPStorm 只是调用它做一次性扫描，不提供像 PHPStorm 自带类型推导那样的实时语义分析。所谓“实时检测”，其实是靠保存时自动触发扫描（需开启），不是边写边标。
立即学习“PHP免费学习笔记（深入）”；
性能影响：全量扫描大项目可能耗时数秒，PHPStorm 默认只扫描当前文件或修改的文件（取决于配置），但这个行为受 phpstan.neon 中 paths: 设置约束——如果 paths 指向整个 src/，那每次保存都会扫全部，卡顿明显。
- 勾选
Run on current file only（在 PHPStan 设置页），避免误配 paths 导致全量扫描 - 关闭
Run PHPStan after save，改用快捷键Ctrl+Shift+A→ 输入Run PHPStan手动触发，更可控 - 别指望它标出
$user->getName()中getName()不存在——那是 PHPStorm 自身索引该干的事，PHPStan 只管类型契约是否被违反
PHPStan 报 Class not found 却实际存在？Autoload 没对上
PHPStan 不依赖 Composer autoload.php，它自己解析类定义。如果项目没用标准 PSR-4 结构，或用了自定义 autoload 逻辑（比如 classmap 或 files），PHPStan 就找不到类，直接报 Class XXX not found，哪怕代码能正常运行。
兼容性影响：PHPStan 0.12+ 默认启用 autoload_files 和 autoload_directories，但旧版配置容易漏掉。
- 在
phpstan.neon里显式声明：autoload_files: [./vendor/autoload.php]（确保指向真实生成的 autoload） - 如果用了
classmap，加autoload_directories: [./src]，让 PHPStan 主动扫描目录 - 别信
composer dump-autoload --optimize生成的 classmap，PHPStan 读不了优化后的内容，必须用未优化的 autoload
Class not found 却查不到原因，其实只是 PHPStan 根本没看到你的类文件。 
