PHPStan需在真实项目中边跑边调，三步上手：装好（composer require --dev）、跑通（配autoload和phpVersion）、压误报（用baseline、stub或ignoreErrors）；避免全局安装、缩进错误等隐性失效。
PHPStan 不是靠“学完”就能用好的工具，它得在真实项目里边跑、边调、边修。你不需要先啃完所有文档，而是从能立刻见效的三步开始：装上、跑通、压住误报。
怎么装 PHPStan 并确保 autoload 生效
PHPStan 必须能准确加载你的类，否则连 User 类都找不到，更别说检查类型了。很多报错根本不是代码问题，而是自动加载没对上。
- 用
composer require --dev phpstan/phpstan安装，别全局装（composer global require），否则可能和项目 PHP 版本或 autoloader 冲突 - 确保
phpstan.neon中有autoload_files: - vendor/autoload.php，尤其当项目用了自定义入口（如 ThinkPHP 的public/index.php）时，不能依赖默认行为 - 如果用的是 PSR-4 自动加载但类名和路径不严格匹配（比如
App\Model\User实际在app/model/user.php），PHPStan会直接跳过该文件——检查composer.json的autoload配置是否与磁盘路径一致
level 设置多少才不卡住又不漏错
level 不是越高越好，它是渐进式约束：level 0 只查语法，level 8 开始推断私有属性类型、泛型协变、构造函数注入等。一上来设 level: 8，旧项目很可能报几百个错误，最后要么关掉，要么删掉配置。
- 新项目：从
level: 7起手，它已覆盖参数类型、返回值、空值解引用、未定义方法等高频问题 - 旧项目：先用
vendor/bin/phpstan analyse --generate-baseline生成phpstan-baseline.neon，再把level设为5或6，后续只对新代码提级 - 注意：level 每升一级，分析时间可能翻倍；level 8+ 在大型项目中单次运行常超 2 分钟，CI 中建议加
parallel: { maximumNumberOfProcesses: 4 }
ThinkPHP/Laravel 等框架常见误报怎么压
框架的魔术方法（__call）、动态属性（$this->request）、容器绑定（app()->make('cache')）会让 PHPStan 大量报 “undefined method/property”，这不是 bug，是它没被告知这些成员存在。
- ThinkPHP：必须装
topthink/think-ide-helper，运行php think ide-helper:generate，再在phpstan.neon加includes: - runtime/ide-helper/think-stubs.php - Laravel：推荐用
barryvdh/laravel-ide-helper生成 stub，并配bootstrapFiles加载服务容器初始化逻辑 - 所有框架都适用的兜底法：用
ignoreErrors精确匹配，例如- '#Call to an undefined method think\Db::[a-zA-Z]+#'- '#Access to an undefined property App\Controller.*::\$request#'
切忌写成- 'undefined'这种宽泛正则，否则会掩盖真错误
为什么加了 phpVersion 还报错？格式必须对齐 PHP_VERSION_ID
phpVersion 不是填 "8.1" 或 "8.1.0"，它必须是整数，且严格等于 PHP 内部的 PHP_VERSION_ID 值。填错会导致 str_contains()、array_is_list() 等新函数被标为“不存在”。
- 查当前环境 ID：运行
php -r "echo PHP_VERSION_ID . PHP_EOL;" - 目标环境是 PHP 8.2.0？填
80200（8×10000 + 2×100 + 0） - 若项目要兼容 8.1 和 8.2，但 CI 固定跑在 8.1 上，就按 8.1 的 ID（
80100）配，否则PHPStan会按 8.2 规则检查，误报一堆“8.2 特性不可用”
真正卡住人的从来不是命令记不住，而是 phpstan.neon 里一个缩进错位、一个路径少斜杠、一个 stub 文件没生成，就让整个分析静默失效。动手前先跑一次 vendor/bin/phpstan analyse --debug src/YourTestFile.php，看它到底加载了哪些文件、跳过了什么——比猜强十倍。
