PHP Psalm静态分析，让你的代码更健壮更安全

发布日期： 2025-09-29 阅读量： 作者： admin

最近我们项目里头，感觉代码越来越有点乱，有时候跑起来才发现有些低级错误，挺烦人的。之前也听说过啥静态分析工具，能提前检查代码问题，正好看到有人提到了 psalm 这玩意儿，就想着自己动手试试看到底咋样。

开始动手折腾

第一步嘛肯定就是装它。我们项目是用 composer 管理依赖的，所以这步倒也简单，直接在项目根目录敲命令：

composer require --dev vimeo/psalm

看着它跑完，依赖就加上了。心里想着，这玩意儿应该就能用了。

第一次运行，有点懵

装好了总得跑跑看。我就试着运行了一下 psalm 的命令，好像是 ./vendor/bin/psalm 这样。结果好家伙，屏幕上哗滚出来一大堆红红绿绿的提示，全是它找到的“问题”。第一次看到这么多，头都大了，感觉这项目是不是没救了。

静下心来配置一下

后来冷静下来想想，新工具刚上手，肯定得配置一下才行。它自己也提示可以生成个配置文件。我就运行了 ./vendor/bin/psalm --init，它就在项目根目录生成了一个文件。

打开这个 XML 文件瞅了瞅，里面东西还挺多。可以设置检查的严格程度（有个 errorLevel），可以指定检查哪些目录，忽略哪些目录（比如 vendor 目录肯定得忽略掉，不然问题更多）。我先大概摸索着改了改，把检查级别稍微调低了一点，想着先解决点明显的问题，别一开始就被劝退了。

挨个解决发现的问题

配置好一点后，再运行 psalm，问题列表看着稍微顺眼点了，虽然还是不少。这时候就没啥捷径了，只能硬着头皮一个一个看，一个一个改。

类型问题最多： 最常见的就是变量类型不对，或者函数参数、返回值没写类型提示，psalm 就会报出来。这个改起来也最直接，就是加上或者修正类型声明。比如以前偷懒没写的 int, string, ?string (表示可能为 null 的字符串) 都得补上。
可能为 null 的问题： 有些变量或者函数返回值可能为 null，但代码里直接就当它肯定有值来用了，这在运行时就是个定时炸弹。psalm 对这个查得挺严，逼着你在使用前必须做检查，或者明确告诉 psalm 你知道这里可能为 null。
没用到的变量或代码： 它还能找出那些定义了但从来没用过的变量、私有方法啥的，这些删掉能让代码干净点。
奇怪的逻辑： 有时候还会报告一些看起来逻辑上有点怪的地方，虽然不一定报错，但值得琢磨一下是不是写得有问题。

这个过程挺折腾的，花了不少时间。特别是老代码，历史遗留问题多，改起来得特别小心，怕改出新 bug。我就先从自己负责的模块开始弄，一点点啃。

集成到日常开发

手动跑命令还是麻烦，后来我就把它集成到我的 PhpStorm 编辑器里了。装了个 Psalm 插件，这样写代码的时候就能实时看到 psalm 报出来的问题，跟拼写检查似的，哪里有红线就去看看，改起来方便多了。

再后来我们还把它加到了代码提交前的钩子（pre-commit hook）里，强制要求提交的代码必须通过 psalm 检查，这样就能保证团队成员提交的代码都至少符合基本的规范，减少了互相review低级错误的时间。

最终效果和感受

搞了这一通下来，虽然过程有点痛苦，特别是刚开始面对满屏错误的时候，但效果还是挺明显的：

我觉得 php psalm 这玩意儿还是挺有用的。虽然一开始需要投入点时间和精力去配置、去修复它发现的问题，但长期来看，对于提升代码质量、减少 bug、规范团队开发，帮助还是挺大的。如果你也觉得项目代码有点乱或者想提前发现些问题，不妨也试试看。

随便看看