NPM安装Jest提示name只能包含URL友好字符报错求助
2026-10-5
NPM 安装 Jest 报错排查方案
报错提示：Sorry, name can only contain URL-friendly characters.
该报错为NPM通用校验错误，和Jest包本身无关，可按以下步骤逐一排查解决：
- 检查当前项目根目录下
package.json的name字段配置，值不能包含中文、空格、特殊字符（非作用域前缀的@、&、*等）、大写字母，需调整为仅由小写字母、数字、短横线、下划线组成的字符串。 - 检查执行的安装命令是否书写错误，正确命令如下：
本地项目安装为开发依赖：npm install jest --save-dev
全局安装：npm install jest -g
若命令中误输入了空格、特殊字符等非法内容，会触发该校验报错。 - 若上述两项配置都正确，执行
npm cache clean --force清除NPM缓存后重试安装。 - 仍报错的话可切换NPM源后重试，执行
npm config set registry https://registry.npmmirror.com可切换为国内常用镜像源，后续如需切回官方源执行npm config set registry https://registry.npmjs.org即可。
内容的提问来源于stack exchange，提问作者undefinedmyself
相关产品推荐
相关产品推荐
