phpstan 找不到 composer 自动加载的类，主因是 autoload 配置未被正确识别；需确认 composer dump-autoload 已执行、autoload-dev 类需显式指定 --autoload-file，且避免在 phpstan.neon 中误覆写 autoload_directories。
PHPStan 找不到 Composer 自动加载的类？先检查 autoload 是否生效
PHPStan 默认依赖 Composer 的自动加载机制，但它不会直接读取 vendor/autoload.php——它会自己模拟 autoloader 行为。如果类找不到，大概率不是 PHPStan 问题，而是你的项目 autoload 配置没被正确识别。
常见错误现象：Class SomeVendorPackageFoo not found，但 php -r "var_dump(class_exists('SomeVendor\Package\Foo'));" 返回 true。
- 确认
composer.json中的autoload或autoload-dev已运行composer dump-autoload（尤其是用了psr-4映射后新增了目录） - PHPStan 默认只加载
autoload，不加载autoload-dev；若测试类或辅助类在autoload-dev下，需显式启用：--autoload-file=vendor/autoload.php - 避免在
phpstan.neon中重复配置autoload_directories覆盖默认行为，除非你清楚自己在绕过什么
Psalm 报 “Unable to resolve class”？stubs 不是万能补丁
Stubs 是用来“告诉” Psalm 某些类存在、结构如何，但它不能替代真实加载。滥用 stubs 容易掩盖 autoload 配置问题，还可能让类型推导变弱。
使用场景：你依赖一个只含二进制的扩展（如 ext-redis），或某个包没提供 PHPDoc/PHP 8+ 类型信息，又或者你想覆盖第三方类的签名。
立即学习“PHP免费学习笔记（深入）”；
- stub 文件必须是纯 PHP（无执行逻辑），且类声明要完整（
class、interface、方法签名、返回类型） - Psalm 不会自动扫描
stubs/目录；必须在psalm.xml中显式声明：<stubs><file name="stubs/redis-stub.php"></file></stubs> - 别把整个
vendor/下的类都 stub 化——这会让 Psalm 失去对实际实现的感知，比如方法是否真被重写、参数是否可为空
PHPStan 的 bootstrapFiles 和 Psalm 的 autoloader 怎么选？
两者目的接近：让分析器提前执行一段代码，用于注册 autoloader、定义常量、或打补丁。但触发时机和风险不同。
PHPStan 的 bootstrapFiles 在分析前执行，适合加载自定义 autoloader 或 patch ComposerAutoloadClassLoader；Psalm 的 autoloader 配置则更克制，只指定入口文件路径，不鼓励执行任意逻辑。
- PHPStan 示例（
phpstan.neon）：parameters: bootstrapFiles: - vendor/autoload.php - tests/bootstrap.php注意：如果tests/bootstrap.php里有require循环或副作用（如修改全局状态），PHPStan 可能静默失败 - Psalm 示例（
psalm.xml）：<autoloader> <file name="vendor/autoload.php"/> </autoloader>
它不会执行文件内容，只是告诉 Psalm “这些类可通过此 autoloader 加载” - 优先用
vendor/autoload.php；只有当你用了非标准 autoloader（如 CodeIgniter 3 的system/core/Loader.php）才考虑自定义 bootstrap
为什么加了 stub 和 bootstrap 还报错？检查类名大小写与命名空间拼写
PHPStan 和 Psalm 都严格区分大小写，且对命名空间末尾反斜杠、use 别名、以及 class_alias 支持有限。很多“找不到类”其实卡在最基础的拼写上。
常见错误现象：Class MyLibHttpClient 报错，但实际类是 MyLibHttpClientClient；或 stub 里写成了 Mylib（少了个 L）。
- 用
composer show --platform确认扩展是否真已加载（如ext-memcached） - 在 stub 文件里，类声明必须和实际反射结果一致：包括
final、abstract、继承关系、接口实现 - Psalm 对
class_alias几乎不支持；PHPStan 仅在运行时 bootstrap 中执行过 alias 才能识别——但这属于 hack，不推荐用于 CI
最麻烦的点往往藏在 composer 包的 autoload 配置里：比如用了 files 加载函数，但没声明对应函数所在文件为 stub；或者 PSR-4 映射漏掉了子目录层级。这类问题没法靠加配置解决，得回 composer.json 里一行行核对。
