Node.js 开发环境搭建全攻略（2025版）

本文将详细介绍如何在本地搭建一个高效、可维护的 Node.js 开发环境，适用于 Windows、macOS 与 Linux。无论你是后端新手还是资深全栈工程师，都能通过本文快速构建一个标准化的 Node.js 开发环境。

一、什么是 Node.js？

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时，它让开发者可以在服务器端运行 JavaScript。 它以 事件驱动、非阻塞 I/O 的特性著称，非常适合构建高性能的 Web 服务和微服务架构。

二、安装 Node.js

1. 使用官方安装包（适合初学者）

访问 Node.js 官方网站你会看到两个版本：

• LTS（长期支持版）：稳定可靠，推荐生产环境使用
• Current（最新功能版）：包含最新特性，适合尝鲜或测试

下载并运行对应操作系统的安装包后，命令行输入以下命令验证安装：

1node -v
2npm -v
3

你应能看到类似输出：

1v20.18.1
210.5.2
3

2. 使用 Node 版本管理器（推荐）

在实际项目中，不同项目可能依赖不同版本的 Node.js。 因此推荐使用版本管理工具，如：

macOS / Linux：

1# 安装 nvm（Node Version Manager）
2curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
3
4# 载入配置
5source ~/.bashrc  # 或 ~/.zshrc
6
7# 安装并使用指定版本
8nvm install 20
9nvm use 20
10

Windows：

使用 nvm-windows：

1nvm install 20.18.1
2nvm use 20.18.1
3

验证版本：

1node -v
2nvm list
3

✅ 优势：

• 多版本 Node 共存
• 快速切换项目环境
• 更易于 CI/CD 集成

三、配置 npm（包管理工具）

Node.js 自带的 npm 是 JavaScript 生态的核心包管理器。

常见配置：

1. 修改全局镜像源（加速安装）

默认源在国外，安装速度较慢，可以改为国内镜像：

1npm config set registry https://registry.npmmirror.com
2

查看是否成功：

1npm config get registry
2

2. 安装全局工具

1npm install -g yarn pnpm nodemon
2

常用工具说明：

四、创建一个 Node.js 项目

1. 初始化项目

1mkdir my-node-app
2cd my-node-app
3npm init -y
4

这会生成一个基本的 package.json 文件。

2. 创建主文件

1touch index.js
2

编辑内容：

1const http = require('http');
2
3const server = http.createServer((req, res) => {
4  res.writeHead(200, {'Content-Type': 'text/plain'});
5  res.end('Hello Node.js!');
6});
7
8server.listen(3000, () => {
9  console.log('Server running at http://localhost:3000/');
10});
11

运行：

1node index.js
2

访问 http://localhost:3000 即可看到结果。

五、使用现代化开发工具

1. VS Code 配置

安装推荐扩展：

• ESLint：代码规范检查
• Prettier：自动格式化
• Node.js Extension Pack：常用 Node 工具集成

添加 .vscode/settings.json：

1{
2  "editor.formatOnSave": true,
3  "editor.codeActionsOnSave": {
4    "source.fixAll.eslint": true
5  }
6}
7

2. 使用 .env 管理环境变量

安装 dotenv：

1npm install dotenv
2

在项目根目录添加 .env 文件：

1PORT=3000
2

修改代码：

1require('dotenv').config();
2const port = process.env.PORT || 3000;
3

六、使用 TypeScript（可选）

现代 Node 项目推荐使用 TypeScript。

1npm install -D typescript ts-node @types/node
2npx tsc --init
3

修改 tsconfig.json：

1{
2  "target": "ES2020",
3  "module": "commonjs",
4  "outDir": "dist",
5  "rootDir": "src",
6  "esModuleInterop": true
7}
8

七、总结

八、结语

到这里，你已经拥有一个完整、可扩展的 Node.js 开发环境。 后续可以基于此环境继续学习：

• 使用 Express / Koa / NestJS 构建后端服务
• 使用 TypeScript + Jest 构建测试体系
• 使用 Docker 容器化部署

《Node.js 开发环境搭建全攻略（2025版）》 是转载文章，点击查看原文。