PHP 8.0 项目集成 PHPStan 需补全 ThinkPHP 运行时类型信息：安装 phpstan/phpstan、phpstan/extension-installer 和 thinkphp/phpstan-thinkphp；配置 phpstan.neon 加载 base.php、限定 paths、排除干扰目录；通过 PHPDoc、类型注释和模型查询修复误报；集成 pre-commit 和 CI 基线保障落地。
PHP 8.0 项目引入 PHPStan 做静态类型检查，核心不是“装上就用”，而是让工具真正理解 ThinkPHP 的运行时行为——比如 __get、__call、容器绑定、动态查询返回值等。否则扫出来的全是误报，开发人员很快就会屏蔽它。
安装必要组件，缺一不可
只装 phpstan/phpstan 是不够的。ThinkPHP 8.0 大量依赖魔术方法和运行时绑定，必须补全适配层：
- 执行
composer require --dev phpstan/phpstan phpstan/extension-installer thinkphp/phpstan-thinkphp -
phpstan/extension-installer 必须存在，否则
thinkphp/phpstan-thinkphp提供的 stub 文件不会自动加载，模型属性访问、Db::name()等调用全标红 - 若项目已用
topthink/think-ide-helper，可额外生成 runtime/ide-helper/think-stubs.php，并在配置中 include 进来，增强对助手函数和门面类的支持
配置 phpstan.neon，聚焦业务、绕过干扰
配置文件决定 PHPStan 看什么、怎么推断。ThinkPHP 项目需特别注意三点：加载框架启动文件、排除无关目录、显式声明路径。
- 必须显式加载
thinkphp/base.php（通过bootstrapFiles），否则Container::get()返回值类型无法识别，所有依赖注入都会报错 -
paths只设- app/和- common/，不扫thinkphp/源码或命令/中间件等非业务代码 - 用
excludePaths屏蔽app/command/、app/middleware/，避免扫描 CLI 工具和中间件带来的噪声 - 加入
includes: - vendor/thinkphp/phpstan-thinkphp/extension.neon，启用 ThinkPHP 官方扩展规则
修复三类高频误报，不靠 @phpstan-ignore
误报不是工具问题，是类型信息缺失。针对性补全，比全局压制更可持续：
立即学习“PHP免费学习笔记（深入）”；
-
控制器参数类型模糊：如
$this->request->param('id')被判为mixed，在调用前加注释// @var int $id，再写$id = (int) $this->request->param('id'); -
模型属性访问报错：在模型类顶部添加 PHPDoc，例如
/** @property-read string $name @property-read int $status */ -
Db 查询结果被当 array|null 无法解构：优先改用模型查询
UserModel::where(...)->find()；若必须用 Db，给变量加注释：// @var array{id: int, name: string}|null $user
集成进开发流程，让检查不卡人
静态检查要轻量、快速、可预期，才能真正落地：
- 在
.git/hooks/pre-commit中写脚本，只跑vendor/bin/phpstan analyse app/ common/ --no-progress --error-format=raw，5 秒内出结果 - CI 中首次运行时用
--generate-baseline生成 baseline.neon，把历史问题冻结，后续只关注新增错误 - 在
composer.json加脚本："analyse": "phpstan analyse"，开发者可随时composer analyse快速验证
