使用npm安装shards-react时遭遇安装错误的解决求助

你遇到的核心问题是iltorb这个已弃用的依赖需要编译二进制文件，但你的Windows环境缺少必要的C++编译工具链，导致node-gyp编译失败。虽然Node.js v10.16.0+已经内置zlib支持brotli，但shards-react的依赖链仍在拉取旧版本的iltorb，直接替换的方法可能没生效。下面是几个可行的解决方案：

方案一：快速跳过可选依赖错误 #

从日志能看到iltorb属于可选依赖，我们可以直接跳过它的安装或忽略编译脚本，快速完成shards-react的安装：

• 忽略所有脚本执行（避免编译步骤）：

npm i shards-react --ignore-scripts

• 或者跳过所有可选依赖：

npm i shards-react --no-optional

方案二：彻底替换iltorb为兼容包（推荐） #

通过npm的overrides功能，强制让依赖链使用无需本地编译的brotli替代包，从根源上避免拉取旧的iltorb：

1. 在项目根目录的package.json中添加以下配置：

{
  "overrides": {
    "iltorb": "npm:@node-rs/brotli@^1.0.0"
  }
}

这个包是预编译的brotli实现，兼容Node.js v14+，无需本地编译环境。
2. 重新执行安装命令：

npm i shards-react

方案三：配置node-gyp编译环境（若必须安装iltorb） #

如果你的依赖链强制要求安装iltorb，需要先解决node-gyp的编译环境问题：

• 安装Visual Studio 2017或更高版本，确保勾选**Desktop development with C++**工作负载，包含MSVC编译器、Windows SDK等核心组件
• 或者以管理员权限打开终端，全局安装windows-build-tools：

npm install --global windows-build-tools --vs2015

安装完成后重启终端，再执行npm i shards-react即可。

这三个方案里，方案一最快捷，方案二是长期解决的最优解，方案三适合需要处理其他原生模块编译的场景。

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