在 Windows 系统中全局安装 Node.js 和 npm 的操作流程

小新

在 Windows 系统中全局安装 Node.js 和 npm 的操作流程非常清晰，且 npm 会随 Node.js 安装包自动附带，无需单独下载。以下是详细的分步指南，包含安装、验证、环境配置及常见问题解决，适用于所有 Windows 版本（Win10/Win11 等）。

Node.js 官方提供了 Windows 安装程序（.msi 格式），包含自动配置环境变量的选项，推荐使用此方式：

访问 Node.js 官方下载页：https://nodejs.org/zh-cn/download/
选择 LTS 版本（长期支持版）：
- LTS 版本稳定性高，适合开发和生产环境，推荐大多数用户选择；
- Current 版本包含最新特性，但可能存在兼容性问题，适合尝鲜用户。
点击「Windows 安装程序」下载（根据系统位数选择 64 位或 32 位，通常选 64 位）。

双击下载的 .msi 安装包，按照以下步骤操作，关键是勾选「自动配置环境变量」：

欢迎页：点击「Next」。
许可协议：勾选「I accept the terms in the License Agreement」，点击「Next」。
安装路径选择（重要）：
- 默认路径为 C:\Program Files\nodejs\（推荐保持默认，避免权限问题）；
- 若需自定义路径（如 D:\Nodejs\），需记住路径，后续验证时会用到；
- 点击「Next」。
自定义安装选项（关键）：
- 务必勾选 「Add to PATH」（自动将 Node.js 和 npm 路径添加到 Windows 全局环境变量，无需手动配置）；
- 其他选项（如「Node.js runtime」「npm package manager」）默认已勾选，无需修改；
- 点击「Next」。
工具安装（可选）：
- 选项「Automatically install the necessary tools…」用于安装编译 native 模块的工具（如 Python、VS Build Tools），若需开发底层模块可勾选，普通用户点击「Next」跳过。
开始安装：点击「Install」，等待进度条完成，最后点击「Finish」。

安装完成后，需通过命令行验证 Node.js 和 npm 是否全局生效，步骤如下：

打开命令行工具：
- 按下 Win + R，输入 cmd 或 powershell，回车打开终端；
- （重要）若之前打开过终端，需重新打开（环境变量需重启终端生效）。
执行验证命令：
- 验证 Node.js：输入 node -v，回车后应显示版本号（如 v20.10.0），表示 Node.js 全局可用；
- 验证 npm：输入 npm -v，回车后应显示版本号（如 10.2.3），表示 npm 随 Node.js 自动安装并全局可用。
✅ 若均显示版本号，说明全局安装成功；若提示「不是内部或外部命令」，需排查环境变量（见下文）。

若验证时提示「命令不存在」，大概率是「Add to PATH」选项未生效，需手动检查/配置环境变量：

打开环境变量设置：
- 方法 1：「此电脑 → 右键属性 → 高级系统设置 → 环境变量」；
- 方法 2：按下 Win + S，搜索「环境变量」，选择「编辑系统环境变量」。
检查「Path」变量：
- 在「系统变量」列表中找到「Path」，双击打开；
- 查看是否存在 Node.js 安装路径（如默认的 C:\Program Files\nodejs\，或自定义的 D:\Nodejs\）：
  - 若存在：点击「确定」关闭所有窗口，重新打开终端再次验证；
  - 若不存在：点击「新建」，粘贴 Node.js 安装路径，点击「确定」保存，再重新打开终端验证。

默认情况下，npm 全局安装的包（如 vue-cli、express）会存放在 C:\Users\你的用户名\AppData\Roaming\npm 目录，若需自定义路径（如避免 C 盘占用），可手动配置：

创建自定义目录：
- 例如在 D 盘创建 D:\Nodejs\npm-global（用于存放全局包）和 D:\Nodejs\npm-cache（用于缓存）。

执行 npm 配置命令：
打开终端，输入以下两条命令（路径替换为你的自定义目录）：

# 配置全局包存放路径
npm config set prefix "D:\Nodejs\npm-global"
# 配置缓存路径
npm config set cache "D:\Nodejs\npm-cache"

更新环境变量（关键）：
- 回到「环境变量」设置，在「用户变量」的「Path」中，将原来的 C:\Users\你的用户名\AppData\Roaming\npm 替换为自定义的 D:\Nodejs\npm-global；
- 保存后重新打开终端，执行 npm install -g vue-cli（示例），验证包是否安装到自定义目录。

安装时提示「权限不足」：
- 右键点击安装包，选择「以管理员身份运行」。
npm 安装包时速度慢：
- 配置淘宝镜像（临时加速）：npm install 包名 --registry=https://registry.npmmirror.com；
- 配置永久镜像：npm config set registry https://registry.npmmirror.com，后续安装无需再加 --registry 参数。
Node.js 版本切换需求：
- 若需在多个 Node.js 版本间切换，推荐安装工具 nvm-windows（Windows 版 Node 版本管理器），具体使用可参考 nvm-windows 官方文档。

通过以上步骤，即可完成 Windows 系统下 Node.js 和 npm 的全局安装，后续可直接在任意终端中使用 node 和 npm 命令进行开发。