Psalm找不到类需先确认autoload是否正确加载：检查是否运行composer dump-autoload、psalm.xml是否启用resolveFromConfigFile并包含对应路径、避免错误配置autoloader属性，stub仅用于补充类型声明而非解决加载问题。
Psalm找不到类？先确认autoload是否被正确加载
Psalm默认依赖Composer的自动加载机制，但它不会直接执行vendor/autoload.php——它会模拟autoloader行为。如果报Unable to resolve class或Class X not found，但php -r "var_dump(class_exists('X'));"返回true，说明问题出在Psalm没读到你的autoload配置。
关键检查点：
- 确保已运行
composer dump-autoload（尤其新增了psr-4映射或改过composer.json后） - Psalm默认只加载
autoload段，不加载autoload-dev；若类在autoload-dev下（如测试工具类、Factories），需在psalm.xml中显式启用：<psalm resolveFromConfigFile="true">并确保<projectFiles>包含对应路径 - 不要在
psalm.xml里手动覆盖<autoloader>指向一个不存在或未加载完整依赖的文件，这反而会绕过Composer原生逻辑
psalm.xml里要不要写autoloader属性？
绝大多数项目不需要显式配置autoloader属性。Psalm从v4起默认自动探测并使用vendor/autoload.php，只要该文件存在且能正常加载项目类即可。
只有以下情况才需要手动指定：
- 项目用了自定义的、非标准的自动加载器（比如绕过Composer自己写的
require链），此时填autoloader="path/to/your/autoloader.php" - 你正在调试autoload问题，想强制Psalm用某个特定入口加载——但这时更推荐先修复
composer.json和dump-autoload -
vendor/autoload.php被重命名或移出标准位置（极少见）
滥用autoloader属性会导致Psalm跳过Composer的classmap、psr-4等真实注册逻辑，反而让类型推导变弱。
stub文件是补救手段，不是autoload替代方案
当你看到Psalm can't resolve class from extension（比如Redis、Swoole）或第三方包缺少PHPDoc时，才考虑用stub。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
正确做法：
- stub文件必须是纯声明式PHP（无
new、无函数调用、无副作用），只含class、interface、方法签名和类型注解 - 在
psalm.xml中显式引入：<stubs><file name="stubs/redis-stub.php"/></stubs>，Psalm不会自动扫描stubs/目录 - 别把整个
vendor/都stub化——这会让Psalm失去对实际实现的感知，比如无法判断某个方法是否被子类重写、参数是否可为null
stub解决的是“Psalm不知道这个类长什么样”，而不是“Psalm找不到这个类”。前者靠stub，后者靠autoload配置。
CI中Psalm失败但本地通过？检查--no-cache和threads
CI环境常因缓存残留或并发干扰导致误报。本地能过、CI失败，大概率是Psalm复用了旧分析结果。
必须加的参数：
-
--no-cache：禁用结果缓存，确保每次都是干净分析（CI必备） -
--threads=2或更高（根据CI机器核数）：加速，但注意某些老版本Psalm在多线程下可能漏报，建议用v5.20+ - 避免在CI脚本里拼接
psalm --init——它会覆盖现有psalm.xml，CI应只运行分析命令
另外确认CI中PHP版本与本地一致，Psalm对PHP 8.2+的联合类型、只读类等支持有版本依赖，低版本Psalm可能直接跳过这些分析。
最易被忽略的一点：Psalm的errorLevel设为4或5时，会开启对构造函数参数类型的严格校验——如果依赖注入容器没配好或服务定义缺失，它会报错，但这不是Psalm的问题，而是暴露了DI配置本身的问题。
