PhpStorm PHP静态分析需三层协同：先配准PHP解释器路径并验证版本，再启用内置检查并调优严重级别，最后集成PHPStan并补充类型提示；任一环节出错均导致分析失效。
PhpStorm 启用 PHP 静态分析，不是开个开关就完事——它分三层：内置检查打底、PHPStan/PSALM 深度把关、类型提示决定准不准。没配对解释器、没加类型注解、没装对路径，再强的工具也报“Configuration is valid”但实际不报错。
确认 PHP 解释器已正确配置
所有静态分析（包括内置检查和 PHPStan）都依赖 PhpStorm 知道你用的是哪个 php。路径错、版本低、CLI 和 Web 用的不是同一个，都会导致分析失效或误报。
- 进
File > Settings > Languages & Frameworks > PHP，点击右上角齿轮 →Add→Local - 路径填
/usr/bin/php（Debian/Ubuntu）或/usr/local/bin/php（macOS/Homebrew）或C:\xampp\php\php.exe（Windows） - 点
Validate，必须看到 PHP 版本号（如8.2.12），否则后续全白搭 - 若用 Docker/WSL，选
Remote Interpreter并配好连接，别硬塞本地路径
启用并调优内置 PHP Inspection
这是最轻量、最实时的静态分析层，覆盖未定义变量、类型不匹配、SQL 注入风险等。它不开，连 foreach ($users as $user) 中 $user 的自动补全都可能失效。
- 进
Settings > Editor > Inspections > PHP - 勾选关键项：
Potential bugs（必开）、Code style issues（可选但建议）、PHP Deprecated features（尤其升级 PHP 版本后） - 把
Undefined variable严重级别设为Error，避免漏掉拼写错误 - 禁用冗余项，比如
Unused symbol在大型遗留项目里会刷屏，先关着，等代码清理后再开
集成 PHPStan 实现深度类型分析
内置检查只能猜类型；PHPStan 能读 @var、function(): User、甚至 array{status: string, code: int}，真正做“编译前校验”。但它不会自动运行——必须手动装、配路径、启插件。
立即学习“PHP免费学习笔记（深入）”；
- 在项目根目录执行：
composer require --dev phpstan/phpstan
- 进
Settings > Languages & Frameworks > PHP > Quality Tools > PHPStan，点右侧按钮选vendor/bin/phpstan - 点
Validate—— 若失败，90% 是 PHP 解释器没配好，或vendor/bin/phpstan权限不对（chmod +x vendor/bin/phpstan） - 安装
PHPStan Support插件（Settings > Plugins > Marketplace搜），重启 IDE；否则右键菜单里没有Run 'PHPStan' - 首次运行建议从
level: 1开始（在phpstan.neon里设），避免被第三方库误报淹没
加类型提示，让静态分析“看得见”
没有类型，PHPStan 就是睁眼瞎。一个 $data = json_decode($json)，IDE 默认当 mixed，后面所有调用都不报错——哪怕你写了 $data->name。
- 用 PHPDoc 补充：
/** @var array{id: int, name: string} $data */$data = json_decode($json, true); - 函数加返回值类型：
function getUser(int $id): ?User（PHP 7.1+） - PHP 8+ 直接用联合类型：
function getId(): int|string|null - 数组形状（需 Psalm 插件）：
#[ArrayShape(['id' => 'int', 'name' => 'string'])]，比注释更可靠
别指望一键开启“全自动静态分析”。解释器路径、vendor/bin/phpstan 可执行权限、@var 注解是否完整——这三个地方任一出错，你看到的都是“没报错”，而不是“没 bug”。
