npm安装报EUNSUPPORTEDPROTOCOL错误，如何自定义提示用户使用pnpm？

你可以通过以下组合方式，实现当用户使用npm/yarn安装时显示自定义提示，并强制使用pnpm：

1. 配置 packageManager 和 engines 字段 #

在项目根目录的package.json中添加以下配置，明确指定项目仅支持pnpm：

{
  "packageManager": "pnpm@8.0.0", // 可根据项目实际使用的pnpm版本调整
  "engines": {
    "pnpm": ">=8.0.0",
    "npm": "never",
    "yarn": "never"
  }
}

2. 启用npm引擎严格检查 #

在项目根目录创建.npmrc文件，添加以下内容，让npm强制校验引擎兼容性：

engine-strict=true

用户使用npm install时，会直接触发引擎不兼容的错误提示，不会进入依赖解析环节（也就不会出现workspace:协议的错误）。

3. 添加自定义preinstall脚本兜底 #

在package.json的scripts中添加preinstall脚本，直接检测当前使用的包管理器，非pnpm则输出提示并终止安装：

"scripts": {
  "preinstall": "node -e \"const pm = process.env.npm_execpath.split('/').pop(); if (!['pnpm', 'pnpm-cli.js'].includes(pm)) { console.error('⚠️ 本项目仅支持使用pnpm安装依赖，请先安装pnpm后再执行安装操作。'); process.exit(1); }\""
}

这个脚本会在yarn/npm执行安装前运行，直接输出自定义提示并退出，避免后续的依赖解析错误。

效果说明 #

• 使用npm install：npm会先校验引擎，输出引擎不兼容的错误，提示需使用pnpm。
• 使用yarn install：yarn会提示引擎不兼容，同时preinstall脚本输出自定义提示后终止安装。
• 使用pnpm install：所有校验通过，正常执行安装流程。

内容的提问来源于stack exchange，提问作者ROHIT SOMVANSHI