phpstan在phpstorm中不实时标红是设计使然，仅保存时扫描当前文件；需安装jetbrains官方phpstan插件、本地安装vendor/bin/phpstan、配置根目录phpstan.neon并启用“run phpstan after save”和“run on current file only”。
PHPStan 在 PhpStorm 中不会自动标红、不会边写边报错，它只在保存文件或手动触发时运行一次扫描——这不是配置错了，是设计如此。
PHPStan 不标红？先确认官方插件已装且重启
PhpStorm 本身不带 PHPStan 支持，必须装 JetBrains 官方维护的 PHPStan Support 插件。插件市场搜 phpstan，只认作者是 JetBrains、图标为蓝白盾牌的那个。装错第三方插件（比如叫“PHP Static Analyzer”的）会导致 Settings → Languages & Frameworks → PHP → PHPStan 根本不出现。装完必须重启 IDE，否则右键菜单里没有 Run PHPStan，设置页也刷不出来。
路径验证失败？别用全局 phpstan，盯紧 vendor/bin/phpstan
PHPStan 必须以项目本地方式安装：composer require --dev phpstan/phpstan。验证失败的常见原因有：
-
vendor/bin/phpstan文件不存在 —— 检查是否真在项目根目录执行了 composer 命令 - 填了
phpstan（全局）或phpstan.phar—— 这会导致 CI 和协作环境版本不一致，也容易因 PHP 版本差异触发dynamicReturnTypeExtensions类加载失败 - Windows 下漏写了
.bat后缀 —— 正确路径是vendor\bin\phpstan.bat - 权限问题 —— Linux/macOS 下执行
chmod +x vendor/bin/phpstan
配置文件不生效？路径、格式、缩进三处最易踩坑
phpstan.neon 必须放在项目根目录（即 $ProjectFileDir$），否则 PhpStorm 会静默退回到 level 0 默认规则。常见失效点：
- 文件放错位置（如
tools/phpstan/phpstan.neon）→ 在设置中手动填绝对路径或$ProjectFileDir$/tools/phpstan/phpstan.neon - 文件开头含 BOM 或用了 Tab 缩进 → YAML 只认空格，用编辑器转成 UTF-8 without BOM + 2 空格缩进
- 空配置文件没写
parameters:根节点 → 即使不设 level，也要有这行，否则报Invalid configuration file -
paths:没包含实际代码目录 → Laravel 项目必须显式列app/Models、app/Services，不能指望 PSR-4 自动发现
为什么改了代码没反应？它只在保存后扫当前文件
PHPStan 不是实时检查器，它依赖 PhpStorm 的 “Save Action” 触发。要让它真正起作用，得两步都配对：
- 勾选
Run PHPStan after save（在Settings → Languages & Frameworks → PHP → PHPStan） - 同时启用
Run on current file only—— 否则若phpstan.neon中paths:写了整个src/，每次保存都会全量扫描，卡顿明显 - 如果不想被自动打断，可关掉自动保存触发，改用快捷键
Ctrl+Shift+A→ 输入Run PHPStan手动执行
最常被忽略的是：PHPStan 的错误提示依赖 @var 注释、函数返回类型、参数类型提示才能准确定位；没加类型信息时，它连 $user->getName() 都可能报 Call to an undefined method —— 这不是工具问题，是你没给它足够线索。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
