跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.js大前端

Node.js 安装指南（Windows 版本）

Node.js 是基于 Chrome V8 引擎的 JavaScript 运行环境。在 Windows 系统上下载、安装及配置 Node.js 的全过程，包括 LTS 与 Current 版本选择、环境变量设置、npm 包管理器使用以及常见问题的解决方法。同时提供了 VS Code 开发环境配置建议和 Express 示例项目创建步骤，帮助开发者快速搭建 Node.js 开发环境并进行基础实践。

CoderByte发布于 2026/3/22更新于 2026/10/26115 浏览

第一部分：Node.js 简介与安装前准备

1.1 Node.js 是什么？

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境，它让开发者能够使用 JavaScript 编写服务器端应用程序。Node.js 的出现彻底改变了 JavaScript 只能运行在浏览器中的局面，使其成为一门全栈开发语言。

主要特点：

  • 事件驱动、非阻塞 I/O 模型
  • 轻量且高效
  • 单线程但支持高并发
  • 拥有庞大的包生态系统（npm）
1.2 为什么选择 Node.js？
  1. 前后端统一语言：使用相同的编程语言开发前端和后端
  2. 高性能：基于 V8 引擎，执行速度快
  3. 丰富的生态系统：npm 拥有超过 100 万个包
  4. 活跃的社区：拥有庞大的开发者社区支持
  5. 企业级应用：被 Netflix、PayPal、LinkedIn 等大型公司使用
1.3 系统要求检查

在安装 Node.js 之前，请确保您的 Windows 系统满足以下要求：

最低系统要求：

  • 操作系统：Windows 8.1、Windows 10、Windows 11 或 Windows Server 2012 R2 及以上
  • 处理器：1 GHz 或更快的处理器
  • 内存：至少 512 MB RAM（推荐 1 GB 或更多）
  • 硬盘空间：至少 200 MB 可用空间

检查您的 Windows 版本：

  1. 按下 Win + R 键
  2. 输入 winver 并按回车
  3. 查看弹出的窗口中的版本信息

第二部分：下载 Node.js 安装包

2.1 访问官方网站
  1. 打开您的网页浏览器（推荐 Chrome、Firefox 或 Edge）
  2. 访问 Node.js 官方网站：https://nodejs.org/
  3. 您将看到两个主要版本选项：

LTS 版本（推荐）

  • 长期支持版本
  • 更稳定，适合生产环境
  • 有长期的安全更新和维护

Current 版本

  • 最新功能版本
  • 包含最新的特性和改进
  • 可能不够稳定，适合测试和开发
2.2 选择合适的版本

对于大多数用户，我们推荐选择 LTS 版本。点击 "LTS" 按钮下载安装包。

版本号说明：

  • 格式：主版本。次版本。修订版本（例如：18.12.1）
  • 偶数主版本号为 LTS 版本（如 14.x, 16.x, 18.x）
  • 奇数主版本号为当前版本（如 15.x, 17.x, 19.x）
2.3 下载选项

Node.js 为 Windows 提供多种安装包格式：

  1. MSI 安装程序（推荐）
    • 扩展名：.msi
    • 优点：图形化安装界面，自动配置环境变量
    • 下载文件示例：node-v18.12.1-x64.msi
  2. 可执行文件
    • 扩展名：.exe
    • 需要手动配置环境变量
  3. 压缩包
    • 扩展名：.zip 或 .7z
    • 适合高级用户，需要手动安装和配置

第三部分：安装 Node.js

3.1 启动安装程序
  1. 找到下载的 .msi 文件（通常在 "下载" 文件夹中）
  2. 双击文件启动安装程序
  3. 如果出现用户账户控制（UAC）提示，点击 "是" 继续
3.2 安装向导步骤

步骤 1：欢迎界面

  • 阅读欢迎信息
  • 点击 "Next" 继续

步骤 2：许可协议

  • 仔细阅读最终用户许可协议
  • 勾选 "I accept the terms in the License Agreement"
  • 点击 "Next" 继续

步骤 3：选择安装位置

  • 默认安装路径：C:\Program Files\nodejs\
  • 如需更改安装位置，点击 "Change" 按钮
  • 建议使用默认路径，除非有特殊需求
  • 点击 "Next" 继续

步骤 4：自定义安装选项

这是最重要的步骤，让我们详细了解每个选项：

Node.js runtime

  • 必选项，包含 Node.js 运行环境
  • 建议：保持选中

npm package manager

  • Node.js 的包管理器
  • 用于安装和管理 JavaScript 包
  • 建议：保持选中

Online documentation shortcuts

  • 创建在线文档的快捷方式
  • 可选，根据个人需求选择

Add to PATH

  • 重要：将 Node.js 添加到系统 PATH 环境变量
  • 这允许在任意命令提示符窗口中使用 node 和 npm 命令
  • 强烈建议：保持选中

步骤 5：自动安装必要工具

  • 这个选项会安装编译本地模块所需的工具
  • 包括 Python、Visual Studio Build Tools 等
  • 对于初学者，可以取消选中此项
  • 如果需要编译 C++ 插件，建议安装

步骤 6：准备安装

  • 确认安装设置
  • 点击 "Install" 开始安装
3.3 安装过程
  1. 安装程序将开始复制文件
  2. 显示安装进度条
  3. 如果选择了安装必要工具，可能会额外下载约 1GB 的文件
  4. 安装时间取决于系统性能和网络速度（通常 2-10 分钟）
3.4 完成安装
  1. 看到 "Completed the Node.js Setup Wizard" 表示安装成功
  2. 点击 "Finish" 退出安装程序

第四部分：验证安装

4.1 检查 Node.js 安装
  1. 打开命令提示符：
    • 按下 Win + R 键
    • 输入 cmd 并按回车
    • 或者搜索 "命令提示符" 并打开
  2. 验证 Node.js 版本：
node --version

应该显示类似：v18.12.1 3. 验证 npm 版本：

npm --version

应该显示类似：8.19.2

4.2 测试简单的 JavaScript 代码
  1. 打开命令提示符
  2. 输入 node 并按回车，进入 Node.js REPL（交互式解释器）
  3. 输入以下代码测试：
console.log("Hello, Node.js!");
  1. 按回车，应该看到输出：Hello, Node.js!
  2. 按 Ctrl + C 两次退出 REPL
4.3 创建并运行第一个 Node.js 脚本
  1. 创建一个新文件夹，例如 C:\nodejs-projects\
  2. 在该文件夹中创建文件 hello.js
  3. 用文本编辑器打开并输入以下内容：
// hello.js
const message = "欢迎来到 Node.js 世界！";
console.log(message);
// 显示当前日期和时间
const currentDate = new Date();
console.log(`当前时间：${currentDate.toLocaleString()}`);
// 简单的计算
const a = 5, b = 3;
console.log(`${a} + ${b} = ${a + b}`);
  1. 保存文件
  2. 在命令提示符中，导航到文件所在目录：
cd C:\nodejs-projects
  1. 运行脚本：
node hello.js
  1. 应该看到类似输出：
欢迎来到 Node.js 世界！
当前时间：2023/11/15 14:30:25
5 + 3 = 8

第五部分：配置开发环境

5.1 选择合适的代码编辑器

推荐编辑器：

  1. Visual Studio Code（强烈推荐）
    • 免费、开源
    • 优秀的 Node.js 支持
    • 丰富的扩展生态系统
  2. WebStorm
    • 付费软件，功能强大
    • 专业的 JavaScript IDE
  3. Sublime Text
    • 轻量级，快速
    • 需要安装插件获得完整功能
5.2 安装 Visual Studio Code
  1. 访问：https://code.visualstudio.com/
  2. 下载 Windows 版本
  3. 运行安装程序
  4. 选择以下组件：
    • 将 "通过 Code 打开" 操作添加到 Windows 资源管理器文件上下文菜单
    • 将 "通过 Code 打开" 操作添加到 Windows 资源管理器目录上下文菜单
    • 将 Code 注册为受支持的文件类型的编辑器
    • 添加到 PATH
5.3 配置 VS Code 扩展

安装以下有用的扩展：

  1. JavaScript (ES6) code snippets
  2. npm
  3. npm Intellisense
  4. Path Intellisense
  5. ESLint
  6. Prettier - Code formatter
  7. Bracket Pair Colorizer
  8. Auto Rename Tag
5.4 配置终端
  1. 在 VS Code 中打开终端：查看 > 终端 或 `Ctrl + ``
  2. 确保终端使用 PowerShell 或命令提示符
  3. 测试 Node.js 命令是否正常工作

第六部分：npm 包管理器详解

6.1 npm 基础概念

npm（Node Package Manager）是 Node.js 的包管理器，世界上最大的软件注册表。

主要功能：

  • 安装和管理依赖包
  • 发布自己的包
  • 运行脚本
  • 版本管理
6.2 常用 npm 命令
# 初始化新项目
npm init
npm init -y # 快速初始化，使用默认配置

# 安装包
npm install package-name # 安装到 dependencies
npm install package-name --save-dev # 安装到 devDependencies
npm install package-name -g # 全局安装

# 卸载包
npm uninstall package-name

# 更新包
npm update package-name
npm update -g # 更新全局包

# 查看已安装的包
npm list
npm list -g # 查看全局包
npm list --depth=0 # 查看顶层包

# 查看包信息
npm view package-name
npm info package-name

# 运行脚本
npm run script-name

# 审计安全性
npm audit
npm audit fix
6.3 package.json 文件详解

package.json 是 Node.js 项目的核心配置文件：

{
  "name": "my-project",
  "version": "1.0.0",
  "description": "我的 Node.js 项目",
  "main": "index.js",
  "scripts": {
    "start": "node index.js",
    "dev": "nodemon index.js",
    "test": "jest"
  },
  "keywords": ["nodejs", "javascript"],
  "author": "你的名字",
  "license": "MIT",
  "dependencies": {
    "express": "^4.18.2",
    "lodash": "^4.17.21"
  },
  "devDependencies": {
    "nodemon": "^2.0.20",
    "jest": "^29.3.1"
  },
  "engines": {
    "node": ">=18.0.0"
  }
}
6.4 依赖类型说明

dependencies

  • 生产环境依赖
  • 使用 npm install package-name --save 安装

devDependencies

  • 开发环境依赖
  • 使用 npm install package-name --save-dev 安装

peerDependencies

  • 对等依赖，表明包与宿主环境的关系

optionalDependencies

  • 可选依赖，安装失败不会影响主要功能

第七部分：高级配置和优化

7.1 配置 npm 镜像源

由于网络原因，有时需要配置国内镜像源：

使用淘宝 npm 镜像：

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com/
# 恢复官方镜像
npm config set registry https://registry.npmjs.org/
# 查看当前配置
npm config list
# 查看镜像地址
npm config get registry

使用 nrm 管理镜像源：

# 安装 nrm
npm install -g nrm
# 列出可用的镜像源
nrm ls
# 使用淘宝镜像
nrm use taobao
# 测试镜像速度
nrm test
7.2 配置全局安装路径

默认情况下，全局包安装在 %APPDATA%\npm，可以自定义路径：

# 创建全局安装目录
mkdir C:\NodeJS\global_modules
mkdir C:\NodeJS\global_cache
# 配置 npm
npm config set prefix "C:\NodeJS\global_modules"
npm config set cache "C:\NodeJS\global_cache"
# 将路径添加到系统 PATH
# 1. 右键 "此电脑" > "属性" > "高级系统设置"
# 2. 点击 "环境变量"
# 3. 在 "系统变量" 中找到 "Path"，点击 "编辑"
# 4. 添加新路径：C:\NodeJS\global_modules
7.3 环境变量配置

确保以下路径在系统 PATH 中：

  • C:\Program Files\nodejs\（Node.js 安装目录）
  • C:\Users\你的用户名\AppData\Roaming\npm（全局包目录，如果使用默认设置）

检查环境变量：

echo %PATH%

第八部分：常见问题解决

8.1 安装问题

问题 1：权限错误

Error: EPERM: operation not permitted

解决方案：

  • 以管理员身份运行命令提示符
  • 或配置自定义全局安装路径

问题 2：Node.js 命令未找到

'node' 不是内部或外部命令，也不是可运行的程序

解决方案：

  • 检查 Node.js 是否安装成功
  • 确认安装路径已添加到系统 PATH
  • 重启命令提示符或计算机
8.2 npm 相关问题

问题 3：npm 安装超时

npm ERR! network timeout

解决方案：

  • 检查网络连接
  • 配置国内镜像源
  • 增加超时时间：npm config set timeout 60000

问题 4：权限被拒绝

npm ERR! Error: EACCES: permission denied

解决方案：

  • 在 Windows 上，以管理员身份运行命令提示符
  • 或使用 npm cache clean --force 清理缓存
8.3 版本管理问题

问题 5：需要特定 Node.js 版本

解决方案： 使用 nvm-windows（Node Version Manager for Windows）

# 安装 nvm-windows
# 下载地址：https://github.com/coreybutler/nvm-windows/releases
# 安装特定版本
nvm install 18.12.1
# 使用特定版本
nvm use 18.12.1
# 列出已安装版本
nvm list
# 设置默认版本
nvm alias default 18.12.1

第九部分：开发工具和最佳实践

9.1 推荐开发工具

调试工具：

  • VS Code 内置调试器
  • Chrome DevTools（通过 --inspect 参数）

进程管理：

  • nodemon：自动重启应用
npm install -g nodemon
nodemon app.js
  • pm2：生产环境进程管理
npm install -g pm2
pm2 start app.js
pm2 monit

测试框架：

  • Jest：JavaScript 测试框架
  • Mocha：功能丰富的测试框架
  • Chai：断言库
9.2 项目结构最佳实践
my-project/
├── src/ # 源代码目录
│   ├── controllers/ # 控制器
│   ├── models/ # 数据模型
│   ├── routes/ # 路由
│   ├── middleware/ # 中间件
│   └── utils/ # 工具函数
├── tests/ # 测试文件
├── public/ # 静态资源
├── node_modules/ # 依赖包（自动生成）
├── package.json # 项目配置
├── package-lock.json # 依赖锁文件
├── .gitignore # Git 忽略文件
├── README.md # 项目说明
└── app.js # 应用入口文件
9.3 代码质量工具

ESLint - 代码检查工具：

npm install eslint --save-dev
npx eslint --init

Prettier - 代码格式化工具：

npm install prettier --save-dev

Husky - Git 钩子工具：

npm install husky --save-dev
npx husky install

第十部分：创建完整的示例项目

10.1 初始化项目
# 创建项目目录
mkdir my-express-app
cd my-express-app
# 初始化 package.json
npm init -y
# 安装 Express 框架
npm install express
# 安装开发依赖
npm install nodemon --save-dev
10.2 创建基础应用

创建 app.js 文件：

const express = require('express');
const app = express();
const port = 3000;

// 中间件
app.use(express.json());
app.use(express.static('public'));

// 路由
app.get('/', (req, res) => {
  res.json({
    message: '欢迎来到 Express 服务器！',
    timestamp: new Date().toISOString(),
    nodeVersion: process.version
  });
});

app.get('/api/users', (req, res) => {
  const users = [
    { id: 1, name: '张三', email: '[email protected]' },
    { id: 2, name: '李四', email: '[email protected]' },
    { id: 3, name: '王五', email: '[email protected]' }
  ];
  res.json(users);
});

app.post('/api/users', (req, res) => {
  const { name, email } = req.body;
  const newUser = {
    id: Date.now(),
    name,
    email,
    createdAt: new Date().toISOString()
  };
  res.status(201).json(newUser);
});

// 错误处理中间件
app.use((err, req, res, next) => {
  console.error(err.stack);
  res.status(500).json({ error: '服务器内部错误！' });
});

// 404 处理
app.use((req, res) => {
  res.status(404).json({ error: '路由未找到！' });
});

// 启动服务器
app.listen(port, () => {
  console.log(`服务器运行在 http://localhost:${port}`);
  console.log(`Node.js 版本：${process.version}`);
});
10.3 配置 package.json 脚本

修改 package.json 的 scripts 部分：

{
  "scripts": {
    "start": "node app.js",
    "dev": "nodemon app.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  }
}
10.4 运行项目
# 开发模式（使用 nodemon）
npm run dev
# 生产模式
npm start

访问 http://localhost:3000/ 查看应用运行情况。

总结

通过本详细指南，您已经完成了：

  1. ✅ 了解了 Node.js 的基本概念和优势
  2. ✅ 下载了合适的 Node.js 版本
  3. ✅ 完成了完整的安装和配置过程
  4. ✅ 验证了安装结果
  5. ✅ 配置了开发环境和工具
  6. ✅ 学习了 npm 包管理器的使用
  7. ✅ 掌握了常见问题的解决方法
  8. ✅ 了解了最佳实践和项目结构
  9. ✅ 创建了完整的示例项目

Node.js 生态系统庞大而活跃，继续学习的方向包括：

  • 深入学习 Express、Koa 等 Web 框架
  • 学习数据库集成（MongoDB、MySQL、PostgreSQL）
  • 掌握 RESTful API 设计
  • 学习身份认证和授权
  • 了解部署和 DevOps 实践

目录

  1. 第一部分：Node.js 简介与安装前准备
  2. 1.1 Node.js 是什么？
  3. 1.2 为什么选择 Node.js？
  4. 1.3 系统要求检查
  5. 第二部分：下载 Node.js 安装包
  6. 2.1 访问官方网站
  7. 2.2 选择合适的版本
  8. 2.3 下载选项
  9. 第三部分：安装 Node.js
  10. 3.1 启动安装程序
  11. 3.2 安装向导步骤
  12. 3.3 安装过程
  13. 3.4 完成安装
  14. 第四部分：验证安装
  15. 4.1 检查 Node.js 安装
  16. 4.2 测试简单的 JavaScript 代码
  17. 4.3 创建并运行第一个 Node.js 脚本
  18. 第五部分：配置开发环境
  19. 5.1 选择合适的代码编辑器
  20. 5.2 安装 Visual Studio Code
  21. 5.3 配置 VS Code 扩展
  22. 5.4 配置终端
  23. 第六部分：npm 包管理器详解
  24. 6.1 npm 基础概念
  25. 6.2 常用 npm 命令
  26. 初始化新项目
  27. 安装包
  28. 卸载包
  29. 更新包
  30. 查看已安装的包
  31. 查看包信息
  32. 运行脚本
  33. 审计安全性
  34. 6.3 package.json 文件详解
  35. 6.4 依赖类型说明
  36. 第七部分：高级配置和优化
  37. 7.1 配置 npm 镜像源
  38. 设置淘宝镜像
  39. 恢复官方镜像
  40. 查看当前配置
  41. 查看镜像地址
  42. 安装 nrm
  43. 列出可用的镜像源
  44. 使用淘宝镜像
  45. 测试镜像速度
  46. 7.2 配置全局安装路径
  47. 创建全局安装目录
  48. 配置 npm
  49. 将路径添加到系统 PATH
  50. 1. 右键 "此电脑" > "属性" > "高级系统设置"
  51. 2. 点击 "环境变量"
  52. 3. 在 "系统变量" 中找到 "Path"，点击 "编辑"
  53. 4. 添加新路径：C:\NodeJS\global_modules
  54. 7.3 环境变量配置
  55. 第八部分：常见问题解决
  56. 8.1 安装问题
  57. 8.2 npm 相关问题
  58. 8.3 版本管理问题
  59. 安装 nvm-windows
  60. 下载地址：https://github.com/coreybutler/nvm-windows/releases
  61. 安装特定版本
  62. 使用特定版本
  63. 列出已安装版本
  64. 设置默认版本
  65. 第九部分：开发工具和最佳实践
  66. 9.1 推荐开发工具
  67. 9.2 项目结构最佳实践
  68. 9.3 代码质量工具
  69. 第十部分：创建完整的示例项目
  70. 10.1 初始化项目
  71. 创建项目目录
  72. 初始化 package.json
  73. 安装 Express 框架
  74. 安装开发依赖
  75. 10.2 创建基础应用
  76. 10.3 配置 package.json 脚本
  77. 10.4 运行项目
  78. 开发模式（使用 nodemon）
  79. 生产模式
  80. 总结

更多推荐文章

查看全部
  • RAG 系统实战：Langchain 框架与纯手搓实现对比
  • SQL 语言全面详解
  • SpringBoot 整合 LangChain4j 实现 RAG 检索实战
  • IntelliJ IDEA Python 开发环境配置与实战
  • 网络安全从业者常用术语与行话解析
  • 大模型提示工程核心技巧与实战应用
  • 基于 YOLO11 的无人机航拍小目标检测系统实战
  • RocketMQ 与 RabbitMQ 深度对比：架构、性能与选型
  • Docker Desktop + WSL2 安装配置与核心应用实战
  • 归并排序非递归实现详解：自底向上策略
  • MySQL MGR 集群部署实战：基于 InnoDB Cluster 与 MySQL Router
  • FPGA 以太网接口设计，纯 Verilog 实现 UDPTCP 协议
  • 一种光伏产品缺陷检测 AI 深度学习算法
  • OpenRFT：基于强化微调实现大模型领域推理泛化
  • MySQL 8.4.7 Windows 免安装版部署与配置详解
  • PostCSS px-to-viewport 移动端适配配置指南
  • Qwen3.5-9B 如何以 1/13 参数量超越 GPT-oss-120B？架构与性能实测
  • LLaMA-Factory 微调 Qwen3-VL 详细流程
  • C++ STL vector 容器模拟实现及迭代器失效问题详解
  • 国产 FPGA 低温低压测试问题反思与总结

相关免费在线工具

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online

  • JavaScript 压缩与混淆

    Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online