❮
EDA All-in-one

Appearance

配置 node 环境

⏱️最后更新: 2025/08/02

🔧 一、安装前准备

TIP

建议系统 win10,支持 win7 系统的最后一个 node 版本是Node.js v13.14.0​​,发布发布于 2020 年,因为我前端开发现在主要是 vue3,而 vue3 要求已安装 18.3 或更高版本的 Node.js,因此win7是不支持的。

  1. 卸载现有 Node.js

    • 进入控制面板 → “程序和功能” → 卸载所有已安装的 Node.js 程序。
    • 手动删除残留文件：
      • 删除 %AppData%\npm 和 %AppData%\npm-cache 文件夹。
      • 清除环境变量中 Node.js 相关路径（如 C:\Program Files\nodejs）。
    • ⚠️ 此步骤避免与 nvm 冲突，必须执行。

  2. 下载 nvm-windows 安装包

⚙️ 二、安装 nvm-windows

  1. 运行安装程序

    • 右键以 管理员身份 运行 nvm-setup.exe。
    • 关键配置项：
      • nvm 安装目录：路径避免空格或中文（如 D:\nvm）。
      • Node.js 符号链接目录：设置为空文件夹（如 D:\nvm\nodejs），nvm 将通过此路径切换版本。

  2. 验证安装

    • 打开新的 CMD 或 PowerShell（管理员权限）：

      bash
      nvm -v

      显示版本号（如 1.1.12）即安装成功。

      TIP

      我个人比较习惯用免安装包的，一般解压到指定路径下，然后配置环境变量就能用了。 picture 0picture 2
      然后在 path 里面追加这两个就可以了 picture 3

🌐 三、配置镜像加速（国内用户必选）

启动 nvm,全局安装 nrm,通过 nrm 管理镜像

bash
nvm install -g nrm
nrm ls
nrm use xxx

picture 1

📦 四、安装与管理 Node.js

  1. 查看可用版本

    bash
    nvm list available  # 显示所有可安装版本

  2. 安装指定版本

    bash
    nvm install 20.17.0  # 安装 LTS 版本
nvm install latest   # 安装最新稳定版

    TIP

    目前我开发主要用的是V22.14.0,本站相关实例在此版本验证。

  3. 切换版本

    bash
    nvm use 20.17.0      # 切换至目标版本

  4. 设置默认版本

    bash
    nvm alias default 20.17.0  # 开机自动使用该版本

  5. 常用命令速查

    命令作用
    nvm ls查看已安装版本
    nvm uninstall 18.13.0卸载指定版本
    nvm current显示当前使用版本

⚠️ 五、常见问题解决

  • 命令无法识别：
    • 重启终端或计算机。
    • 检查环境变量：确保 Path 包含 D:\nvm 和 D:\nvm\nodejs。
  • 切换版本失败（exit status 1）：
    • 以管理员权限运行终端。
  • 安装超时或失败：
    • 关闭杀毒软件/防火墙。
    • 确认 settings.txt 镜像配置正确。

💎 六、最佳实践建议

  1. 目录结构优化

    D:\nvm
├── nodejs      # 符号链接目录（勿删！）
└── settings.txt

  2. 全局包路径配置（可选）

    bash
    npm config set prefix "D:\nvm\npm_global"
npm config set cache "D:\nvm\npm_cache"
    • 避免不同 Node 版本下全局包重复安装。

✅ 验证环境

bash
node -v  # 显示当前 Node 版本
npm -v   # 显示 npm 版本

若输出版本号，则环境配置成功！🎉