PHPStan 1.10 可有效检查 ThinkPHP 8 代码，但需绕过魔术方法、动态属性和 Facade 代理机制；须安装 phpstan/extension-installer 和 thinkphp/phpstan-thinkphp 扩展，配置 bootstrapFiles、includes、paths 及 level: 7，并修复 request、模型属性、Db 数组访问三类误报，最后集成至 Git 钩子与 CI。
PHPStan 1.10 可以有效检查 ThinkPHP 8 代码，但必须绕过框架的魔术方法、动态属性和 Facade 代理机制，否则会大量误报。核心不是“能不能用”，而是“怎么配才不被 TP8 的动态性干扰”。
安装适配 ThinkPHP 8 的必要扩展
TP8 大量使用 __get/__call、容器绑定、Facade 静态代理，PHPStan 默认无法识别这些调用。只装 phpstan/phpstan 是不够的：
- 运行
composer require --dev phpstan/phpstan phpstan/extension-installer thinkphp/phpstan-thinkphp -
phpstan/extension-installer 必须存在——它负责自动加载
thinkphp/phpstan-thinkphp提供的 stub 和配置 - 若已装
topthink/think-ide-helper，可额外运行php think ide-helper:generate生成runtime/ide-helper/think-stubs.php，并在配置中引入
配置 phpstan.neon 加载框架上下文
默认配置下，Container::get() 返回值类型无法推断，$this->request 被判为 mixed，所有依赖注入都报错。需显式补全环境：
- 在
phpstan.neon中写入bootstrapFiles: - thinkphp/base.php - thinkphp/helper.php - 添加
includes: - vendor/thinkphp/phpstan-thinkphp/extension.neon -
paths应覆盖app/、common/、config/；排除public/、runtime/、vendor/和命令行类目录（如app/command/） - 设置
level: 7（推荐），兼顾检出率与可维护性；phpVersion: 80000明确声明 PHP 8.0+
修复三类高频误报
PHPStan 报错本身不是问题，问题在于哪些该修、哪些该注释、哪些该忽略：
立即学习“PHP免费学习笔记（深入）”；
-
控制器里 request()->param() 返回 mixed：在调用前加注释，例如
// @var int $id，再写$id = (int) $this->request->param('id'); -
模型属性访问报 “undefined property”：在模型类顶部补
/** @property-read string $name @property-read int $status */ -
Db::table()->find() 后取
$result['name']报数组偏移错误：优先改用模型查询；若必须用 Db，加注释// @var array{id: int, name: string}|null $result
集成到开发与提交流程
静态分析只有跑起来才算真正启用。建议配合 Git 钩子防止带隐患代码合入：
- 用 Husky 初始化 pre-commit 钩子：
npx husky-init && npm install - 配置
lint-staged仅扫描暂存区的app/**/*.php和route/**/*.php - 钩子命令设为
npx lint-staged，对应执行phpstan analyse --no-interaction - CI 中首次运行后，可用
--generate-baseline生成基线文件，后续只报新增问题
