
### 🟢 第一步：下载与安装


#### 1. 下载安装包


- **官网地址**：https://nodejs.org/ 
![image.png](https://developer.qcloudimg.com/http-save/yehe-2276240/f87c9a5dd13c90b896a9c3798346921f.png)
- **版本选择**：
	- **LTS (Long Term Support)**：**推荐✅**。偶数版本号（如 v20, v22,v24），稳定性高，适合生产环境和大多数开发者。
	- **Current**：奇数版本号，包含最新特性但不稳定，仅适合尝鲜。

- **操作**：点击绿色的 **LTS** 按钮，自动下载对应系统的安装包。


#### 2. 安装步骤 (以 Windows 为例)


1. 双击下载的 `.msi` 文件。
![image.png](https://developer.qcloudimg.com/http-save/yehe-2276240/f87c9a5dd13c90b896a9c3798346921f.png)
![image.png](https://developer.qcloudimg.com/http-save/yehe-2276240/be117077631ac59564fb075dd0b325f3.png)
2. **同意协议**：勾选 "I accept..."，点击 Next。
![image.png](https://developer.qcloudimg.com/http-save/yehe-2276240/a047dfaa7a85705e079a0aa85cdf494b.png)
3. **选择路径 (关键)**：
	- 默认路径通常在 `C:\Program Files\nodejs\`。
	- **建议**：如果 C 盘空间紧张，可点击 `Change` 修改到其他盘（如 `D:\DevTools\nodejs\`）。**注意：路径中不要包含中文或空格！**
![image.png](https://developer.qcloudimg.com/http-save/yehe-2276240/07d4e1c180d76e9677c0a6bc5492ab5e.png)
4. **组件选择**：保持默认（通常包括 `npm package manager` 和 `Add to PATH`），直接 Next。
![image.png](https://developer.qcloudimg.com/http-save/yehe-2276240/bedb55f6f692535376e64656147784bc.png)
5. **安装工具**：如果提示安装 "Tools for Native Modules" (Python/VS Build Tools)，初学者可先**不勾选**（后续按需安装），直接 Next 以加快安装速度。
![image.png](https://developer.qcloudimg.com/http-save/yehe-2276240/992c61a96744b5ef36f22fa0d096eb1b.png)
6. 点击 **Install** 完成安装。


----

### 🔵 第二步：验证安装


打开命令行工具（Windows: `Win+R` 输入 `cmd`；Mac/Linux: `Terminal`），输入以下命令：

```
node -v
npm -v
```

- 如果输出了版本号（例如 `v20.11.0` 和 `10.2.4`），说明安装成功。

- ❌ **如果提示“不是内部或外部命令”**：说明环境变量未生效，请重启命令行窗口或重新检查安装步骤中的 "Add to PATH" 选项。


----

### 🟠 第三步：优化环境配置 (强烈推荐)


默认配置会将全局包安装在 C 盘，且下载源在国外速度慢。建议进行以下优化：

#### 1. 修改全局包和缓存路径 (避免 C 盘爆满)


在安装目录下（例如 `D:\DevTools\nodejs\`）创建两个新文件夹：


- `node_global` (存放全局安装的包，如 vue-cli, typescript)

- `node_cache` (存放 npm 缓存)


然后在命令行执行以下命令（**注意替换为你实际的路径**）：

```
# 设置全局安装路径
npm config set prefix "D:\DevTools\nodejs\node_global"

# 设置缓存路径
npm config set cache "D:\DevTools\nodejs\node_cache"
```
#### 2. 配置国内镜像源 (提速 10 倍+)


由于 npm 官方源在国内访问较慢，建议切换到国内镜像（如淘宝镜像或腾讯云镜像）。

```
# 设置淘宝镜像 (2026 年最新源)
npm config set registry https://registry.npmmirror.com

# 验证是否设置成功
npm config get registry
# 输出应为：https://registry.npmmirror.com/
```
#### 3. 更新环境变量 (Windows 用户必做)


如果你修改了全局路径 (`node_global`)，需要将其添加到系统环境变量中，否则全局命令（如 `vue`）无法使用。


1. 按 `Win + S` 搜索 **"编辑系统环境变量"**。

2. 点击 **"环境变量"**。

3. 在 **"系统变量"** 中找到 `Path`，选中并点击 **"编辑"**。

4. 点击 **"新建"**，添加你的全局包路径：
	- `D:\DevTools\nodejs\node_global` (即你刚才设置的 prefix 路径)

5. **删除** 旧的 `C:\Program Files\nodejs\` (如果有)，或者确保新的路径排在前面。

6. 连续点击 **确定** 保存。


----

### 🟣 第四步：最终测试


打开一个新的命令行窗口（必须新开，以加载最新的环境变量），运行：

```
# 1. 再次验证版本
node -v
npm -v

# 2. 测试全局安装 (以安装 vite 为例)
npm install -g vite

# 3. 验证命令是否可用
vite -v
```
如果能看到 `vite` 的版本号，恭喜！你的 Node.js 环境已经完美配置好了。🎉


----

### 💡 常见问题与进阶技巧


#### 1. 如何管理多个 Node.js 版本？


不同项目可能需要不同版本的 Node.js（例如老项目用 v14，新项目用 v20）。推荐使用 **版本管理工具**：


- **Windows**: 推荐使用 `fnm` (Fast Node Manager) 或 `nvm-windows`。
	- 安装 fnm: `winget install Schniz.fnm`
	- 使用: `fnm use 20`, `fnm use 18`

- **Mac/Linux**: 推荐使用 `nvm` 或 `fnm`。
	- 安装: 参考官方脚本。
	- 使用: `nvm install 20`, `nvm use 20`


#### 2. 权限错误 (EACCES / Permission denied)


- **Mac/Linux**: 如果 `npm install -g` 报错权限不足，**不要**直接使用 `sudo`。正确的做法是确保 `npm config get prefix` 指向的目录属于当前用户，或者使用 `nvm` 管理版本。

- **Windows**: 如果遇到权限问题，尝试以 **管理员身份** 运行 CMD 或 PowerShell。


#### 3. 检查当前配置


随时可以使用以下命令查看当前 npm 的配置情况：

```
npm config list
```
现在你已经拥有了一个干净、快速且易于管理的 Node.js 开发环境！可以开始你的项目开发了。

- 👤 **关于作者**：
	**专注技术落地，深耕硬核干货**
	本文作者致力于不同于浅层的概念科普，作者坚持 **“手算 + 代码”** 的深度分享模式，主张通过手动推演理解算法本质，结合生产级代码验证理论可行性。
	请关注我主页：[https://cloud.tencent.com/developer/user/2276240]

LTS (Long Term Support)：推荐✅。偶数版本号（如 v20, v22,v24），稳定性高，适合生产环境和大多数开发者。

Node.js 安装与环境配置

根据 2026 年最新的开发环境要求，以下是 Node.js 安装与环境配置 的完整指南。为了获得最佳稳定性和兼容性，强烈建议安装 LTS（长期支持）版本（目前主流为 v20.x 或 v22.x或 v24.x）。

后端

编程语言

开发工具

Node.js安装与配置全指南：从下载到优化环境。推荐LTS稳定版，详解Windows安装步骤，验证安装方法。优化全局包路径避免C盘爆满，配置国内镜像源提速10倍+。解决常见问题如版本管理、权限错误，提供进阶技巧。适合开发者快速搭建高效Node.js开发环境。

命令行工具

Windows

Python

Linux

2026新春采购季

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Node.js 安装与环境配置-腾讯云开发者社区-腾讯云

Node.js 安装与环境配置

Node.js 安装与环境配置

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐