使用n工具切换Node版本时遭遇“download preflight failed”错误求助

以下是几种可行的解决办法：

• 检查网络连通性
  先手动测试目标下载链接的可用性，执行命令：

  curl -v https://nodejs.org/dist/v16.16.0/node-v16.16.0-darwin-arm64.tar.xz
  

  如果同样超时，说明是网络层面的问题（如DNS解析失败、防火墙限制或服务器访问延迟），需先排查网络环境。

• 用国内镜像源加速下载
  n工具支持通过环境变量指定镜像源，国内镜像能大幅提升下载速度，避免超时。执行以下命令：

  export N_NODE_MIRROR=https://npmmirror.com/mirrors/node/
  sudo n 16.16.0
  

  若想永久生效，可将export N_NODE_MIRROR=https://npmmirror.com/mirrors/node/添加到shell配置文件（如~/.zshrc或~/.bash_profile），再执行source ~/.zshrc（对应你的配置文件）使设置生效。

• 手动下载后本地安装
  先找到对应版本的darwin-arm64压缩包下载到本地（比如~/Downloads目录），再用n工具的本地安装功能：

  sudo n install ~/Downloads/node-v16.16.0-darwin-arm64.tar.xz
  

• 切换到其他版本管理工具
  如果n工具的网络问题持续无法解决，可尝试使用nvm：

  1. 用Homebrew安装nvm：brew install nvm
  2. 按提示将nvm的配置代码添加到shell配置文件
  3. 安装指定版本：nvm install 16.16.0
  4. 切换版本：nvm use 16.16.0

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