将vite别名替换为@voidzero-dev/vite-plus-core时pnpm报错误peer依赖警告

问题背景 #

使用Vite+项目安装@tailwindcss/vite时，pnpm触发了误导性的peer依赖警告——虽然Vite+通过符号链接将vite指向兼容的@voidzero-dev/vite-plus-core，但pnpm读取的是该包的版本号0.1.12，不符合@tailwindcss/vite和@voidzero-dev/vite-plus-test声明的Vite版本要求。

解决步骤 #

方法一：精准忽略特定包的Peer依赖检查 #

在项目的package.json中，修改pnpm配置块，添加peerDependencyRules来指定忽略目标包的警告：

{
  // ... 其他配置项
  "pnpm": {
    "overrides": {
      "vite": "npm:@voidzero-dev/vite-plus-core@latest",
      "vitest": "npm:@voidzero-dev/vite-plus-test@latest"
    },
    "peerDependencyRules": {
      "ignorePackageNames": [
        "@tailwindcss/vite",
        "@voidzero-dev/vite-plus-test"
      ]
    }
  }
}

方法二：忽略所有缺失的Vite Peer依赖 #

如果需要更宽泛的规则，可以直接忽略所有针对vite的缺失peer依赖警告：

{
  // ... 其他配置项
  "pnpm": {
    "overrides": {
      "vite": "npm:@voidzero-dev/vite-plus-core@latest",
      "vitest": "npm:@voidzero-dev/vite-plus-test@latest"
    },
    "peerDependencyRules": {
      "ignoreMissing": ["vite"]
    }
  }
}

验证修改 #

保存package.json后，重新执行vp install或pnpm install，之前的peer依赖警告就会消失。

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