PHPStan 和 Psalm 依赖 Composer 的 autoload 配置（如 psr-4、files 等）来识别类、函数和命名空间，需确保 composer.json 映射准确并执行 composer dump-autoload；PSR-4 为首选，测试目录和全局函数文件需显式声明，符号未被 autoload 覆盖将导致“Class not found”等错误。
PHPStan 和 Psalm 会自动读取 Composer 的 autoload 配置（如 psr-4、psr-0、classmap 和 files），无需额外配置即可识别已声明的类、接口、函数和命名空间。关键在于确保 composer.json 中的 autoload 设置准确，且已运行 composer dump-autoload（尤其是开发时修改了映射后）。
确保 autoload 配置完整且规范
PHPStan/ Psalm 依赖 Composer 生成的 vendor/autoload.php 或其内部映射来解析符号来源。若类在代码中被引用但未被 autoload 覆盖，工具会报 “Class not found” 或 “Unable to resolve …” 类错误。
-
PSR-4 是首选：推荐用
"App\\": "src/"这类清晰映射，避免路径歧义 -
不要遗漏测试目录：如果测试中用了自定义类（如 fixture 或 test helpers），需单独为
tests/加 autoload（例如"Autoload\\Test\\": "tests/fixtures/"） -
functions.php 等全局文件要用
files：如"files": ["src/helpers.php"]，否则 Psalm 可能无法识别其中的函数
让静态分析工具感知 vendor 外的代码
默认情况下，PHPStan/ Psalm 只扫描你指定的源目录（如 src/、tests/），但它们仍需知道这些目录里的类“该去哪找”。这时 autoload 就是桥梁。
- 在
phpstan.neon中，通过parameters > autoload_directories可补充额外路径（用于未被 Composer 管理的代码） - Psalm 使用
--autoloader参数指向自定义加载器，但优先建议统一走 Composer autoload - 若项目含 symlink 目录（如 Docker 开发中挂载的 src），确认
composer dump-autoload --optimize不会跳过它们（必要时加--no-dev测试是否干扰）
排查 autoload 相关误报的常见操作
当工具提示“Class XXX not found”，不一定是代码错，很可能是 autoload 断链。
立即学习“PHP免费学习笔记（深入）”；
- 运行
composer dump-autoload -o刷新优化后的类映射 - 用
composer show --path vendor/package-name验证包路径是否符合 PSR-4 声明 - 检查大小写：Linux 下
Src/Helper.php声明namespace src;会导致加载失败，autoload 是大小写敏感的 - 在 PHPStan 中临时加
parameters: { inferPrivatePropertyTypeFromConstructor: true }有时可绕过因构造注入导致的类型推断中断（间接缓解 autoload 未覆盖的副作用）
基本上就这些。Composer autoload 不是“给运行时用的”，它也是静态分析的元数据基础——只要映射对了，工具就能顺藤摸瓜；一旦断开，类型推导和符号解析就会卡住。不复杂但容易忽略。
