phpstan.neon必须放在项目根目录且命名准确；paths需显式指定业务目录，excludepaths跳过无关路径；bootstrapfiles加载框架启动文件解决未定义问题；level应循序渐进，配合baseline控制误报。
phpstan.neon 文件必须放在项目根目录
PHPStan 默认只认项目根目录下的 phpstan.neon，名字不能是 phpstan.yaml、.neon 或其他变体。如果放错位置（比如丢进 config/ 或 app/），运行 phpstan analyse 时会提示 No configuration file found，或者退回到默认 level 0 行为，几乎不报错。
paths 和 excludePaths 必须显式列出真实代码目录
PHPStan 不会自动扫描 src/，除非你明确写进 paths。Webman、ThinkPHP、Laravel 等框架结构各异，常见错误是照搬文档写 - src/，结果 app/、route/、config/ 全被漏掉，大量类型问题逃逸。
-
paths应覆盖实际含业务逻辑的目录：例如 Webman 项目要写- app/、- route/、- support/ -
excludePaths用于跳过生成代码或命令类：如- app/command/、- runtime/、- vendor/（虽然 vendor 默认已排除） - 路径末尾不加斜杠，写成
- app或- app/都可，但风格需统一；相对路径以composer.json所在目录为基准
bootstrapFiles 是解决“未定义方法”和“动态属性”的关键
像 $this->db、app()、Db::table() 这类调用，在 PHPStan 看来全是“未定义”，不是你代码写错了，而是它根本没加载框架启动逻辑。必须通过 bootstrapFiles 显式引入入口文件。
- ThinkPHP 8.0 必须包含
- thinkphp/base.php，否则所有容器绑定都失效 - Webman 必须写
- start.php（或- bootstrap/start.php），否则$this->redis全标红 - 若用了全局 helper 函数（如
config()、env()），还得补autoload_files: ["app/Helper.php"]
level 值不是越高越好，得配合项目现状选
level 从 0 到 9，每级增加一类检查（比如 level 5 开始校验返回值类型，level 7 校验魔术方法）。新项目可直接设 level: 7，但老项目贸然设到 7 或 8，会爆出几百个错误，反而没法推进。
- 刚接入时建议从
level: 5起步，修复完再升到 6 - 用
phpstan analyse --generate-baseline生成phpstan-baseline.neon，先把历史问题隔离，只对新代码提要求 - CI 流程中别硬写死
level: 8，应搭配 baseline 使用，否则 PR 直接被卡住
配置真正生效的前提，是 phpstan.neon 被正确读取且没有语法错误——Neon 文件缩进敏感，parameters: 下所有字段必须缩进 2 或 4 个空格，不能混用 Tab；任何一行多一个空格或少一个冒号，都会导致 Invalid configuration 错误，但提示极不友好，只说“failed to load config”。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
