PHPStan默认仅做语法校验（level 0）且不自动加载类，需手动配置phpstan.neon文件明确指定level、paths和autoload_files三要素，缺一即无法识别自定义类和方法，导致零报错假象。
PHPStan 是当前 PHP 静态分析最值得投入的学习目标——它不依赖运行时，开箱即用能发现 Call to an undefined method、Undefined variable、类型不匹配等真实阻碍上线的问题，而不是只检查空格缩进。
为什么刚跑 phpstan analyse 什么都没报？
不是工具没用，是它默认只做语法合法性校验（level 0），且不自动加载你的类。常见表现：
- 所有自定义类标红，提示
Class not found -
$user->getName()报Call to an undefined method，哪怕方法确实存在 - 整个
src/目录被跳过，输出只有0 errors
必须手动创建 phpstan.neon 并写死三要素：
parameters:
level: 5
paths:
- src
- tests
autoload_files:
- vendor/autoload.php缺任意一项，phpstan 就等于没真正启动。
立即学习“PHP免费学习笔记（深入）”；
phpstan.neon 里 level 设多少才合适？
级别不是越高越好，而是要匹配项目现状：
- 新项目或重构中：从
level: 7开始，能覆盖方法签名、返回类型、属性存在性 - 遗留项目：必须从
level: 1或2起步，配合--generate-baseline生成基线文件，把已有问题冻结，只对新增代码提要求 - CI 中建议加
--no-progress --error-format=raw，避免彩色输出干扰日志解析
别信“直接上 level 8”的教程——90% 的团队卡在 level 3～4，因为第三方库 stub 缺失、框架魔法方法未适配，强行拉高只会让所有人关掉检查。
怎么让 phpstan 看懂 Laravel 的 $request->input()？
这不是你代码写错了，是 phpstan 默认不认识框架的动态行为。不能靠注释硬补，得用官方扩展：
- Laravel 项目：运行
composer require --dev phpstan/phpstan-laravel，再在phpstan.neon里加bootstrapFiles: [bootstrap/app.php]（路径按实际调整） - Symfony 项目：装
phpstan/phpstan-symfony，它会自动读取services.yaml推断服务类型 - 自己写的 helper 函数？在
phpstan.neon里用includes:引入单独的phpstan-extensions.neon文件，里面配scanFiles
别手动复制 .phpstorm.meta.php 进去——phpstan 完全不识别那种格式。
本地能过，CI 报错或超时，通常卡在哪？
不是性能问题，是环境配置漂移。重点核对三点：
-
phpstan.neon中的paths是否只含src/和tests/？CI 里若误含storage/或node_modules/，扫描路径爆炸式增长 - CI 中是否执行了
composer install --with-all-dependencies？否则dev依赖（如phpstan-laravel）根本没装 - GitHub Actions / GitLab CI 的工作目录是否和
phpstan.neon路径匹配？推荐显式指定配置：phpstan analyse --configuration=phpstan.neon
最容易被忽略的是 autoload_files 在 CI 中的路径有效性——vendor/autoload.php 必须存在且可读，否则整个 autoloader 失效，level 再高也没意义。
