新包命名规则下如何提前校验npm包名的真实可用性？

确实，npm推行《New Package Moniker rules》之后，这个“相似包名”的校验问题真的挺闹心——明明npm search或者第三方工具显示包名可用，结果一执行npm publish .就报错，白忙活半天。我整理了几种不用实际发布就能准确校验包名可用性的方法，亲测有效：

1. 使用npm官方校验API（最可靠） #

npm提供了专门的包名校验接口，能直接返回包名是否符合所有规则（包括和现有包名过于相似的情况）。你可以用curl或者任何HTTP请求工具调用这个接口：

curl https://registry.npmjs.org/-/package/{你的包名}/validate

把{你的包名}替换成你要检查的名称，比如查re.quest就执行：

curl https://registry.npmjs.org/-/package/re.quest/validate

如果包名不符合规则（比如和request过于相似），返回的JSON里会包含errors字段，明确说明问题；如果返回空对象{}，就代表包名是可用的。

2. 更新第三方工具到最新版本 #

像你提到的npm-name-cli，旧版本可能没适配新的命名规则，导致误判。你可以直接用npx调用最新版本来检查：

npx npm-name-cli@latest 你的包名

不过需要注意，第三方工具的校验逻辑还是依赖npm的接口，偶尔可能存在延迟，所以优先级不如官方API高。

为什么之前的方法不准？ #

• npm search是基于关键词的模糊搜索，只会匹配包含目标字符串的包，不会校验命名规则里的“相似性”要求；
• 旧版的npm-name-cli没有同步npm的新规则，所以会错误标记相似包名为“可用”。

内容的提问来源于stack exchange，提问作者kozlov.am