Windows系统下使用asdf安装Node.js 18.16.0失败求助

问题描述 #

刚学习后端开发，使用asdf安装Node.js时出现下载失败错误，无法安装任何版本。环境信息：

• 目标Node.js版本：18.16.0
• asdf版本：v0.11.3-0adc6c1
• npm版本：9.5.1
• 操作系统：Windows

执行安装命令时出现如下错误：

Trying to update node-build... ok
Downloading node-v18.16.0.tar.gz...
-> https://nodejs.org/dist/v18.16.0/node-v18.16.0.tar.gz
error: failed to download node-v18.16.0.tar.gz
-> https://nodejs.org/dist/v18.16.0/node-v18.16.0.tar.gz
error: failed to download node-v18.16.0.tar.gz

BUILD FAILED (MINGW64_NT-10.0-19044 3.3.4-341.x86_64 using node-build 4.9.116)

已尝试的命令：

$ asdf plugin-add nodejs
$ asdf install nodejs 18.16.0
$ asdf global nodejs 18.16.0

期望完成Node.js安装并设置为全局版本。

解决方案 #

1. 手动下载安装包到缓存目录 #

• 下载Node.js安装包：node-v18.16.0.tar.gz
• 找到asdf node-build的缓存目录（Git Bash路径）：~/.asdf/plugins/nodejs/.node-build/cache
• 将下载好的tar.gz文件放入该目录，重新执行安装命令：

  asdf install nodejs 18.16.0
  

2. 更换Node.js镜像源 #

国内访问官方源可能存在网络问题，可切换到国内镜像：

• 临时生效（当前会话）：

  export NODE_BUILD_MIRROR=https://npmmirror.com/mirrors/node/
  asdf install nodejs 18.16.0
  

• 永久生效（添加到Shell配置文件）：
  编辑~/.bashrc或~/.zshrc，加入以下内容：

  export NODE_BUILD_MIRROR=https://npmmirror.com/mirrors/node/
  

  执行source ~/.bashrc（或对应配置文件）使更改生效，再执行安装命令。

3. 检查Windows下的Shell环境 #

asdf在Windows上需要依赖Git Bash或WSL2环境，确保你是在Git Bash或WSL2终端中执行命令，而非CMD或PowerShell（原生Windows终端对asdf支持有限）。

4. 重新安装nodejs插件 #

可能插件存在损坏，重新添加插件：

asdf plugin remove nodejs
asdf plugin add nodejs https://github.com/asdf-vm/asdf-nodejs.git
asdf install nodejs 18.16.0

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