phpstan 默认不报错是因为仅启用最低等级（level 0）且未配置 autoload_files 和 paths；需手动创建 phpstan.neon 指定 level、paths 和 autoload_files 才能启用有效静态分析。

PHPStan 能在不运行代码的前提下发现大量类型错误、未定义变量、错误的函数调用等，但默认配置下它几乎不报错——必须手动启用严格规则并配置 autoloader，否则等于没用。

为什么 phpstan analyse 什么都没报？

PHPStan 默认只检查语法合法性，不启用任何静态分析规则。它把“是否检查类型”“是否检查未定义属性”等全交给配置文件控制。

• 首次运行时若无 phpstan.neon，它会用最低等级（level 0），仅检测最基础的解析错误
• 不配置 autoload 或 autoload_files，类名解析失败，大量“Class not found”被静默跳过
• Composer 自动加载未启用时，src/ 下的类对 PHPStan 来说是“不可见”的

最简可用配置：三行写死 phpstan.neon

在项目根目录新建 phpstan.neon，内容如下（适配 Composer 标准结构）：

parameters:
    level: 5
    paths:
        - src/
        - tests/
    autoload_files:
        - vendor/autoload.php

说明：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• level: 5 是实用起点：覆盖方法签名、返回类型、属性存在性，又不会因 level 8+ 过度报错劝退
• paths 必须显式指定，PHPStan 不自动扫描 src/；若含 app/ 或 lib/，也要加进去
• autoload_files 是关键：没有这行，哪怕 vendor/autoload.php 存在，PHPStan 也看不到你的类

遇到 Call to an undefined method 怎么办？

这不是代码错，是 PHPStan 没识别出对象的实际类型，常见于动态构造、工厂模式或 Doctrine/ORM 实体管理器返回值。

• 优先检查该类是否在 paths 中，且已通过 autoload_files 加载
• 若方法来自 trait 或接口实现，确认 trait 文件是否被 autoload_files 包含，或使用 scanFiles 显式加入
• 临时方案：在调用处加 PHPDoc 注解，例如 /** @var MyService $service */，比关检查更安全
• 避免用 ignoreErrors 全局屏蔽，容易掩盖真实问题

和 IDE、CI 集成时要注意什么？

本地跑通 ≠ CI 里能用，常见断点在路径和环境差异。

• CI 中执行前确保已运行 composer install --no-dev（若测试代码需分析，则加 --with-all-dependencies）
• GitLab CI / GitHub Actions 中，phpstan.neon 路径必须相对于工作目录，建议用 phpstan analyse --configuration=phpstan.neon 显式指定
• VS Code 中装了 PHPStan 插件但无提示？检查插件设置里的 phpstan.executablePath 是否指向正确的二进制（如 vendor/bin/phpstan）
• 不要在 phpstan.neon 里写相对路径如 ../config，PHPStan 解析时 cwd 不稳定，一律用项目根目录为基准

PHPStan 的威力不在“开箱即用”，而在你愿意花十分钟配好 autoload_files 和 level——漏掉这两项，剩下的所有高级特性都建立在流沙之上。

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！