PHPStan 必须本地安装并显式配置 paths、autoload_files 和 level，否则默认仅 level 0 语法检查且不扫描任何目录，导致静默跳过文件或大量 Class not found 错误。
PHPStan 不能靠 Composer “引入”就直接分析代码结构——它必须本地安装、显式配置路径和自动加载，否则 phpstan analyse 要么静默跳过文件，要么报一堆 Class not found。
为什么 phpstan analyse 什么都没报？
不是工具坏了，是 PHPStan 默认只启用 level 0（仅语法合法性检查），且不扫描任何目录，除非你手动写 phpstan.neon。
-
paths必须显式列出要分析的目录，例如- src/或- app/；它不会自动猜 - 没配
autoload_files: - vendor/autoload.php，PHPStan 就看不到你项目里的类，所有方法调用都会被当成“未定义” - 如果项目用了自定义 autoloader（比如
bootstrap.php），得把它加进autoload_files，而不是依赖 Composer 的 autoload 配置 - 运行
vendor/bin/phpstan analyse时若没带--configuration=phpstan.neon参数，它可能读不到你刚写的配置
如何让 PHPStan 真正识别你的类和方法？
关键在三件事：路径、自动加载、级别。少一个，Call to an undefined method 这类错误就会泛滥，而且不是代码错，是 PHPStan “看不见”。
- 确认
phpstan.neon里paths包含所有源码目录，比如- src/、- lib/、- tests/（如果测试也要扫） -
autoload_files必须指向可执行的自动加载入口，99% 的情况就是vendor/autoload.php；别写成composer.json或autoload.php（相对路径） - 从
level: 5开始，它能检查方法签名、返回类型、属性存在性；level: 0到4基本只报空指针或语法级错误，实战价值低 - 如果用了 Laravel/Symfony 的魔法方法（如
__call、__get），得额外装对应扩展，比如phpstan/phpstan-symfony，否则大量误报
CI 里跑失败，但本地好好的？
常见于路径错位、vendor/ 没装全、或 phpstan.neon 被 gitignore 了——CI 环境里没有 IDE 缓存帮你兜底。
立即学习“PHP免费学习笔记（深入）”；
- GitLab CI / GitHub Actions 中，务必用绝对路径或显式指定配置：
phpstan analyse --configuration=phpstan.neon --no-progress - 确保
composer install --no-dev没跳过 dev 依赖（如果分析要扫tests/，就得加--with-all-dependencies） - 别把
phpstan.neon放进vendor/或子目录，它必须在项目根目录，且 CI 工作目录要和你本地一致 - PHP 版本不匹配也会导致静默失败：PHPStan v1.x 要求 PHP ≥ 7.4，v2.x 要求 ≥ 8.1；CI 镜像里 PHP 版本容易被忽略
最常被跳过的其实是 autoload_files 这一行——它看起来像可选配置，实则是 PHPStan 能否理解你项目结构的分水岭。没这行，再高的 level 也白搭。
