Node安装及情况配置+Node多版本管理【Window/macOS】

装 Node 不难，难的是装完之后怎么在不同项目间切换版本、以及下载慢怎么破。这篇把 Windows 与 macOS 两条路径都走一遍：官方安装包、系统包管理器（Chocolatey / Homebrew），以及 nvs 这个 Node 版本管理工具，最后附下载失败的常见解法。

一、官方安装包：最基础的一层

到 Node.js 官网下载对应的安装包。Windows 下是 .msi，双击一路 Next 即可；它会自动把 node 加进 PATH，装完新开一个命令行窗口验证：

node -v
npm -v

装完记得配置一下环境变量：Windows 的 PATH 里检查 C:\Program Files\nodejs\ 在不在；如果安装时勾选了「自动安装必要工具」才会连带装 npm 的构建依赖（Python、Visual Studio 组件），不需要源码编译插件的话可以跳过。

二、Windows：用 Chocolatey 做包管理

Chocolatey 是 Windows 上的包管理器，角色接近 Linux 的 apt 或 yum，一个命令装、升、卸。安装它自己：

# 在 cmd 里
@"%SystemRoot%\System32\WindowsPowerShell\v1.0\powershell.exe" -NoProfile -InputFormat None -ExecutionPolicy Bypass -Command "[System.Net.ServicePointManager]::SecurityProtocol=3072; iex((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))" && SET "PATH=%PATH%;%ALLUSERSPROFILE%\chocolatey\bin"

在 PowerShell 里也可以用精简版：

Set-ExecutionPolicy Bypass -Scope Process -Force;
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072;
iex((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

常用命令：

命令	作用
choco search something	搜包
choco list	列出已装包
choco install baretail	安装包
choco pin windirstat	固定版本，防止被升级
choco upgrade baretail	升级包
choco uninstall baretail	卸载包

三、macOS：用 Homebrew 做包管理

Homebrew 是 macOS（也能跑 Linux）上的包管理器，装它只要一条命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

按终端提示走完。验证：

brew doctor

没有输出报错就正常。装 nvs（Node 版本管理器）：

brew install nvs

命令	作用
brew search	搜可用软件
brew install	安装指定软件
brew uninstall	卸载
brew list	列出已装软件与版本
brew update	更新 Homebrew 本身与索引
brew upgrade	升级所有已装软件
brew outdated	列出有更新的软件
brew cleanup	清理旧版本与缓存
brew info	看软件信息与依赖
brew deps	看依赖
brew doctor	体检并给修复建议
brew tap / brew untap	添加 / 移除第三方仓库
brew cask install	装 macOS 图形应用

四、nvs：真正的多版本管理

包管理器解决「装不装得上」，nvs 解决「装几个、切哪个」。Windows 下：

choco install nvs

核心命令：

命令	作用
nvs remote [name] [uri]	通过 URI 添加一个远程源
nvs add	把某个远程包下载到本地
nvs use [version]	切换版本，只对当前命令行窗口有效
nvs link [version]	切换为全局默认版本
nvs unlink [version]	取消全局版本设置
nvs rm	删除本地某个版本

其他常用项：

nvs help                 # 查看详细帮助
nvs install              # 初始化 shell 配置，让 nvs 在终端可用
nvs --version            # 看 nvs 自身版本
nvs menu                 # 弹交互式菜单
nvs migrate [to ver]     # 迁移全局已装模块
nvs upgrade [from ver]   # 升到某主版本的最新补丁
nvs auto [on/off]        # 按当前目录自动切版本
nvs run [args...]        # 用指定版本跑一个脚本
nvs exec [args...]       # 用指定版本跑一个可执行文件
nvs which [version]      # 显示某个版本 node 的路径
nvs ls [filter]          # 列出本地已装版本
nvs ls-remote [filter]   # 列出可下载的版本
nvs alias [name] [value] # 设置或取回版本别名

实际装用一个版本：

# 看帮助
nvs -h

# 看本地已装
nvs ls

# 装指定版本
nvs add 16.18.0

# 切到该版本
nvs use v16.18.0

# 验证
node -v

五、下载失败：换成国内镜像

报错 Failed to download index: https://nodejs.org/dist/index.json 是典型的镜像地址问题，把 nvs 的远程源指向 npm 镜像即可。先定位配置文件：

where nvs

在输出的目录里找到 setting.json，把 remotes 里的 node 改成国内镜像：

{
  "aliases": {},
  "remotes": {
    "default": "node",
    "node": "https://npmmirror.com/mirrors/node/",
    "iojs": "https://iojs.org/dist/",
    "nightly": "https://nodejs.org/download/nightly/",
    "chakracore": "https://nodejs.org/download/chakracore-release/",
    "chakracore-nightly": "https://nodejs.org/download/chakracore-nightly/"
  }
}

结论

三条线可以叠着用：官方安装包做兜底 → Chocolatey / Homebrew 管装卸载 → nvs 管多版本切换。日常开发在 Windows 上是 choco install nvs + nvs add 16.18.0 + nvs link，macOS 上是 brew install nvs 后同样一套 nvs 命令。下载慢就改 setting.json 里的 remotes 指向 npmmirror，这一条能解决九成的索引拉取失败。

qidao123.com企服评测-应用市场 编辑提示