PHPStan是PHP静态分析最实用起点，需按项目阶段配置level、精准设置paths（如-src、-tests）和excludePaths（如-storage），配合phpstan-laravel等扩展解决框架魔法方法问题，baseline文件用于过渡而非豁免。
PHP静态分析不是“选一个工具装上就能用”，而是要按项目阶段、错误类型和团队能力做针对性配置。PHPStan 是当前最实用的起点，它不依赖运行时、误报率低、CI集成顺滑，但直接开 level 8 会炸出几百个错误——别硬扛，得拆解。
phpstan.neon 配置文件里 paths 和 excludePaths 怎么写才不漏扫也不卡死
paths 写错会导致类找不到、方法签名不校验；excludePaths 漏配会让 vendor 或 storage 目录拖慢分析甚至 OOM。
-
paths必须只包含你写的代码目录，典型值是- src、- tests、- app（Laravel 项目），不要加vendor或node_modules -
excludePaths不是用来“兜底”的，而是精准跳过生成文件或历史遗留模块，例如- %rootDir%/src/LegacyController.php或- %rootDir%/storage - 如果用了
scanDirectories引入第三方包源码（如自研 SDK），必须确保其 autoload 已被bootstrapFiles加载，否则类名解析失败 - CI 中超时？先检查
paths是否意外包含了vendor/bin或大体积日志目录——PHPStan 会递归扫描所有 PHP 文件
level 5 报 “Call to an undefined method” 是框架魔法导致的，怎么修不伤架构
这不是代码 bug，是 PHPStan 默认不理解 Laravel 的 $request->input()、Eloquent 的动态属性访问等行为。硬加 @var 注解或关规则会掩盖真实问题。
- 装对应扩展：
composer require --dev phpstan/phpstan-laravel（Laravel）或phpstan/phpstan-symfony（Symfony） - 在
phpstan.neon中配bootstrapFiles加载框架启动文件，例如- %rootDir%/bootstrap/app.php，让 PHPStan 能读取容器定义 - 对自定义 helper 函数，别手写 stub，用
includes引入你自己的phpstan-extensions.neon文件，里面声明函数签名 - 避免在
ignoreErrors里写正则屏蔽整类错误，比如'#Call to an undefined method.*#'——这会跳过你真写错的方法调用
CI 里 phpstan analyse 总是 timeout，本地却秒出结果
根本原因几乎全是 autoloader 或路径配置偏差，不是性能问题。PHPStan 在 CI 容器里找不到类，就会反复 fallback 解析，卡在 AST 构建阶段。
立即学习“PHP免费学习笔记（深入）”；
- 确认
phpstan.neon中的autoload_files指向的是vendor/autoload.php，且该文件在 CI 环境中真实存在并可读 - 检查 Composer 是否在 CI 中执行了
install --no-dev——如果删了 dev-dependencies，phpstan本身可能还在，但phpstan-laravel这类扩展就没了 - 加
--debug参数跑一次：vendor/bin/phpstan analyse --debug src，看卡在哪一行文件解析上（常见于某个.php文件末尾少了?>或编码为 UTF-8 BOM） - 内存不够？用
php -dmemory_limit=2G vendor/bin/phpstan analyse，但优先排查配置而非加内存
legacy 项目不敢开 high level，baseline 文件怎么用才不变成摆设
--generate-baseline 生成的 phpstan-baseline.neon 不是“永久豁免证”，它是过渡杠杆——用来锁定当前错误量，再逐步收紧。
- 生成后立刻提交到 Git：
vendor/bin/phpstan analyse --generate-baseline，然后git add phpstan-baseline.neon - CI 中改用
vendor/bin/phpstan analyse --configuration=phpstan-baseline.neon，这样新代码引入的错误会单独报出，老错误不干扰 - 每修复一类错误（比如所有
Undefined variable），就删掉 baseline 里对应条目，再重新生成一次 baseline —— 不是一次清空 - baseline 文件里别手动改
count: 0来假装没错误，PHPStan 会校验 checksum，改了就失效
真正卡住团队落地的，从来不是工具本身，而是把 level 当开关、把 ignoreErrors 当胶带、把 baseline 当免责协议。静态分析的价值，在于让每个新增错误都不可忽略，而不是让旧错误变得不可见。
