PHPStan 必须本地安装，因全局安装会导致配置失效、扩展不注册、autoload_files 失效；Laravel 项目还需同时安装 phpstan/extension-installer 和 phpstan/phpstan-laravel 才能正确解析 Facade、Eloquent 和容器绑定。
PHPStan 必须本地安装，全局安装会导致 phpstan.neon 配置被忽略、扩展不注册、autoload_files 失效，甚至静默跳过文件——这不是配置问题，是根本没走对加载路径。
为什么不能用 composer global require phpstan/phpstan
PHPStan 的配置发现、扩展自动注册（如 phpstan-laravel）、bootstrapFiles 加载，全部依赖 Composer 的本地 vendor/ 目录结构和 autoloader。全局安装后，vendor/bin/phpstan 启动时找不到项目级 composer.json 和 autoload.php，直接退化为“裸运行”，所有自定义规则失效。
- 现象：运行
./vendor/bin/phpstan analyse却提示Class not found且无堆栈，或完全不报错但跳过app/目录 - 验证方式：执行
php -r "var_dump(class_exists('PHPStan\Analyser\NodeScopeResolver'));"—— 若返回bool(false)，说明 autoloader 没加载成功 - 正确做法：只在项目根目录执行
composer require --dev phpstan/phpstan
Laravel 项目必须装的三个包
只装 phpstan/phpstan 在 Laravel 中等于白装：Facade 解析失败、Eloquent 属性推断为空、容器绑定类型丢失。官方扩展依赖 phpstan/extension-installer 才能自动挂载。
- 缺
phpstan/extension-installer：即使装了phpstan/phpstan-laravel，includes也不会自动生效，scanModels: true形同虚设 - 缺
phpstan/phpstan-laravel：Auth::user()返回mixed，User::first()不推断为User|null - 命令必须一次性执行：
composer require --dev phpstan/phpstan phpstan/phpstan-laravel phpstan/extension-installer - 检查是否生效：运行
./vendor/bin/phpstan analyse --debug app/Http/Controllers，若看到Loading extension from vendor/phpstan/phpstan-laravel/extension.neon行，说明加载成功
phpstan.neon 配置里最容易写错的三处
phpstan.neon 不是模板粘贴就行，路径、级别、包含逻辑稍有偏差就导致分析范围失控或规则不触发。
立即学习“PHP免费学习笔记（深入）”；
-
paths:下写成- ./src或- src/（末尾斜杠缺失）——部分版本会跳过子目录，统一用- src/（带尾部斜杠） -
level:设为9却没配bootstrapFiles:加载模型工厂，database/factories/*.php中的类无法解析，直接报大量Class not found -
includes:写- vendor/phpstan/phpstan-laravel/extension.neon但没确认该路径存在——Laravel 项目应优先用phpstan/extension-installer自动处理，手动 include 容易路径错误 - 推荐最小可用配置（Laravel）：
includes: - vendor/phpstan/phpstan-laravel/extension.neon parameters: level: 5 paths: - app/ - database/ - routes/ - tests/ bootstrapFiles: - database/factories/UserFactory.php
泛型支持要升级到 v1.10+，别碰 phpstan-generics
PHPStan 自 v1.10 起已原生支持泛型（Collection<user></user> 级别推断），旧版 phpstan/phpstan-generics 包已被归档并明确标注 deprecated。
- 错误操作：执行
composer require --dev phpstan/phpstan-generics→ 安装失败或与主包冲突 - 正确操作：检查
composer.json中"phpstan/phpstan": "^0.12"这类旧约束，手动改为"^1.10"，再运行composer update phpstan/phpstan - 验证是否启用：在代码中写
$users = new Collection<user>(); $users->first()->getName();</user>，若未报错说明泛型解析正常
最常被忽略的是 bootstrapFiles 和 phpstan/extension-installer 的组合效果——它们不是可选项，而是 Laravel 项目让 PHPStan “看懂”框架语法的基础设施。漏掉任何一个，分析结果就只是“语法检查”，不是“框架感知的静态分析”。
