国内如何安装 nodejs 和 npm，
2026-05-08
国内如何安装 nodejs 和 npm，我的操作系统是 windows
思考过程
1. **理解用户需求：**
* **目标：** 安装 Node.js 和 npm。
* **地点：** 中国国内（“国内”）。这是关键细节，因为它意味着网络限制（如防火墙/GFW）可能会影响下载速度以及对官方注册表的访问。
* **操作系统：** Windows。
2. **确定核心安装方法：**
* 方法 1：官方安装包（通过镜像下载）。
* 方法 2：包管理器（通过镜像使用 nvm-windows）。
* 方法 3：Windows 上的 WSL（Linux 子系统）——*可选提及，但对开发者有益。*
3. **解决“国内”因素（最关键的部分）：**
* 由于网络较慢或被屏蔽，直接从 `nodejs.org` 下载通常不稳定或非常慢。
* *解决方案：* 使用国内镜像（淘宝镜像/TaoBao Mirror，目前域名为 `npmmirror.com`）。
* npm 默认连接到 `registry.npmjs.org`，这在国内出了名的慢。安装后*必须*切换 npm 镜像。
4. **分步指南制定：**
* **方法 1：使用官网/镜像安装包（最适合新手）**
* *第一步：下载。* 不要去 `nodejs.org`，而是前往 `nodejs.cn`（中文 Node.js 官网）或 `npmmirror.com`（淘宝镜像）。
* *第二步：安装。* 运行 `.msi` 安装包。强调勾选“Automatically install the necessary tools”（虽然可选，但强烈推荐，因为它会安装 Python/VS 构建工具）。
* *第三步：验证。* 打开 CMD/PowerShell 并运行 `node -v` 和 `npm -v`。
* **方法 2：使用 NVM-windows（最适合开发者/多项目）**
* *原因：* 不同项目需要不同的 Node 版本。NVM 是标准做法。
* *第一步：下载 nvm-windows。* 从 GitHub 仓库获取，或者更好的是，从淘宝镜像获取以加快下载速度。
* *第二步：安装 NVM。* 运行安装程序。
* *第三步：配置 NVM 镜像。* 这对国内环境*至关重要*。编辑 `settings.txt` 添加 Node 和 npm 的淘宝镜像。
* *第四步：安装 Node。* `nvm install lts`（长期支持版）。
* *第五步：使用 Node。* `nvm use <version>`。
* *第六步：验证。* `node -v`，`npm -v`。
* **安装后关键步骤：配置 npm 镜像**
* 即使 Node 和 npm 安装成功，运行 `npm install` 也会失败/极慢。
* *配置：* `npm config set registry https://registry.npmmirror.com/`
* *验证：* `npm config get registry`
* *替代方案：* 提及 `nrm`（NPM 镜像源管理工具）作为专业提示。
5. **额外提示/常见陷阱（附加价值）：**
* 权限：如果遇到权限错误，请以管理员身份运行 CMD/PowerShell（特别是针对 `nvm use`）。
* 执行策略：Windows 上的新版本 npm 有时会因为 PowerShell 执行策略而报错。提供命令：`Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser`。
* pnpm/yarn：简要提及替代包管理器及其镜像设置。
6. **审查与完善（自我纠正）：**
* *我是否解决了 Windows 环境问题？* 是的，`.msi` 安装包，CMD/PowerShell 命令。
* *我是否解决了国内环境问题？* 是的，重点强调了淘宝/npmmirror 镜像用于下载 Node、NVM 以及 npm 注册表。
* *npm 镜像 URL 是否正确？* 旧的 `registry.npm.taobao.org` 已被弃用。必须使用 `https://registry.npmmirror.com/`。（应用了关键更新）。
* *语气是否有帮助且结构清晰？* 使用格式（加粗、代码块）使其易读。
7. **生成输出：**（将结构化的想法翻译成之前提供的详细中文回复。）
在国内的 Windows 环境下安装 Node.js 和 npm，最大的痛点是**网络问题**（下载慢、官方源访问不稳定）。
针对这个问题，推荐以下两种最主流的安装方式。**强烈推荐方式二**，因为它不仅能解决下载慢的问题，还能方便以后切换 Node 版本。
---
### 方式一：直接下载国内镜像安装包（最简单，适合新手）
如果你只是想快速装好能用，不需要经常切换 Node 版本，选这种方式。
1. **不要去官网下载**，直接访问国内淘宝镜像站（Node.js 中文网）：
👉 [https://nodejs.cn/download/](https://nodejs.cn/download/)
2. 选择你需要的版本（建议选 LTS 长期支持版），下载 Windows 64位的 `.msi` 安装包。
3. 双击运行 `.msi` 安装包，一路点击 "Next"。
4. **注意勾选**：在安装界面中，确保勾选了 **`Automatically install the necessary tools`**（自动安装必要工具，包含 Python 和 VS 构建工具，以后安装某些原生 npm 包时会用到）。
5. 安装完成后，按 `Win + R`，输入 `cmd` 回车。在命令行输入：
```bash
node -v
npm -v
```
如果能正确输出版本号，说明安装成功。
---
### 方式二：使用 NVM for Windows 安装（最推荐，适合开发者）
如果你以后可能需要在不同 Node 版本之间切换（比如旧项目用 Node 14，新项目用 Node 18），或者想彻底解决国内下载慢的问题，强烈推荐使用 **nvm-windows**。
1. **卸载已安装的 Node.js**（如果之前装过，必须先卸载干净，否则会冲突）。
2. 下载 **nvm-windows** 的国内镜像安装包：
👉 前往淘宝镜像站：[https://npmmirror.com/mirrors/nvm/](https://npmmirror.com/mirrors/nvm/)
找到最新的 `nvm-setup.exe` 下载并安装。
3. **配置国内镜像源**：
安装完成后，找到 NVM 的安装目录（默认是 `C:\Users\你的用户名\AppData\Roaming\nvm`），打开 `settings.txt` 文件，在最后面加上两行镜像配置：
```text
node_mirror: https://npmmirror.com/mirrors/node/
npm_mirror: https://npmmirror.com/mirrors/npm/
```
4. **打开 CMD 或 PowerShell（建议以管理员身份运行）**，安装你需要的 Node 版本：
```bash
# 安装最新的长期支持版
nvm install lts
# 或者安装指定版本
nvm install 18.18.0
# 查看你安装的所有版本
nvm list
# 切换到你要使用的版本
nvm use 18.18.0
```
5. 验证安装：
```bash
node -v
npm -v
```
---
### ⚠️ 安装后的最重要一步：切换 npm 源
虽然 Node 和 npm 已经装好了，但 npm 默认的下载源在国外，运行 `npm install` 时依然会极慢或报错。**必须将 npm 源切换到国内镜像**。
在命令行中运行以下命令，将 npm 镜像源切换为淘宝最新源：
```bash
npm config set registry https://registry.npmmirror.com/
```
**验证是否切换成功：**
```bash
npm config get registry
```
如果输出是 `https://registry.npmmirror.com/`，说明配置成功。以后运行 `npm install` 就能享受满速下载了。
---
### 常见问题排雷（Windows 专属）
1. **执行策略报错（无法加载文件...因为在此系统上禁止运行脚本）**：
在 Windows PowerShell 中运行 npm 命令有时会遇到这个报错。
**解决方法**：以管理员身份打开 PowerShell，运行：
```powershell
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
```
输入 `Y` 回车即可。
2. **npm 全局安装包报错（权限不足）**：
尽量**不要**在 Windows 的 `C:\Program Files` 等受系统保护的目录下安装 Node。
如果使用 nvm 安装，默认目录在用户文件夹下，一般不会有权限问题。
3. **关于旧版淘宝镜像域名的提醒**：
以前的淘宝镜像域名是 `registry.npm.taobao.org`，**该域名已于 2024 年初正式停止服务**。如果你看网上老的教程配置了这个域名，请务必替换为上面提到的新域名 `registry.npmmirror.com`。