Psalm 默认严格模式易对老项目动态特性误报，应先确认全项目扫描或增量检查模式，再通过 psalm --init 适配PHP版本与框架；用 @psalm-suppress 精准抑制、补全 stubs、保留 level="4" 并禁用非必要插件与污点分析。
明确 Psalm 的运行模式与项目上下文
Psalm 默认以“严格模式”分析代码，但老项目常含动态调用、魔术方法、运行时扩展等非静态可推断结构，容易触发大量误报。先确认 Psalm 是在 全项目扫描 还是 增量检查 模式下运行——后者依赖缓存和 stubs，对未加载的类/函数更宽容。执行 psalm --init 时选择匹配项目实际 PHP 版本（如 7.3）和框架类型（如 none 或 thinkphp），能自动禁用不适用的检查项。
精准屏蔽已知安全的动态行为
老项目常见 method_exists + 变量函数、call_user_func、__call 等模式，Psalm 会报 InvalidArgument 或 UndefinedMethod。不要全局关闭，而是用内联注释精准抑制：
-
// @psalm-suppress UndefinedMethod放在调用行上方，仅对该行生效 - 对整块动态调用逻辑加
/** @psalm-suppress InvalidArgument, UndefinedMethod */ - 若某类大量使用魔术方法，可在其 class docblock 中加
@psalm-allow-private-mutation或@psalm-immutable（视实际语义）
补全缺失的 stubs 和扩展定义
PHP 7.3 老项目常依赖未被 Psalm 内置识别的扩展（如 geoip、mcrypt）或自定义函数（如全局 dump()、dd()）。误报多源于 Psalm “看不见”这些符号：
- 在
psalm.xml的<stubs>节点下添加对应 stub 文件路径，例如<file name="stubs/geoip.phpstub" /> - 为自定义函数写简易 stub：创建
stubs/helpers.phpstub，内容为<?php function dump($var): void {} - 确保
mbstring、gd、pdo等基础扩展已在psalm.xml的<projectFiles>中声明启用（Psalm 不自动探测扩展加载状态）
调整级别与启用兼容性规则
直接降级 level="1" 会掩盖真实问题。更稳妥的做法是保留 level="4"（推荐老项目起点），再针对性放宽：
立即学习“PHP免费学习笔记（深入）”；
- 在
psalm.xml中添加<TaintAnalysis enabled="false"/>—— 老项目极少做完整污点追踪，开启反而产生大量不可判定误报 - 禁用 PHP 7.3 已废弃但项目仍在用的检查：
<Plugin className="Psalm\Plugin\Internal\UnusedVariableChecker" enabled="false"/>（避免因create_function等残留用法误报） - 添加
<ForbiddenFunctions>自定义白名单，把项目中合法使用的“危险函数”（如eval在模板引擎中）显式标记为允许
