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（最新功能版）：包含最新特性，适合尝鲜或测试

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

node -v
npm -v

你应能看到类似输出：

v20.18.1
10.5.2

---

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

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

macOS / Linux：

# 安装 nvm（Node Version Manager）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

# 载入配置
source ~/.bashrc  # 或 ~/.zshrc

# 安装并使用指定版本
nvm install 20
nvm use 20

Windows：

使用 nvm-windows：

nvm install 20.18.1
nvm use 20.18.1

验证版本：

node -v
nvm list

✅ 优势：

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

---

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

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

常见配置：

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

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

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

查看是否成功：

npm config get registry

2. 安装全局工具

npm install -g yarn pnpm nodemon

常用工具说明：

工具	作用
yarn / pnpm	更快的包管理器
nodemon	自动重启 Node 服务
typescript	TypeScript 支持
eslint	代码规范检查

---

四、创建一个 Node.js 项目

1. 初始化项目

mkdir my-node-app
cd my-node-app
npm init -y

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

2. 创建主文件

touch index.js

编辑内容：

const http = require('http');

const server = http.createServer((req, res) => {
  res.writeHead(200, {'Content-Type': 'text/plain'});
  res.end('Hello Node.js!');
});

server.listen(3000, () => {
  console.log('Server running at http://localhost:3000/');
});

运行：

node index.js

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

---

五、使用现代化开发工具

1. VS Code 配置

安装推荐扩展：

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

添加 .vscode/settings.json：

{
  "editor.formatOnSave": true,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": true
  }
}

---

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

安装 dotenv：

npm install dotenv

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

PORT=3000

修改代码：

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

---

六、使用 TypeScript（可选）

现代 Node 项目推荐使用 TypeScript。

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

修改 tsconfig.json：

{
  "target": "ES2020",
  "module": "commonjs",
  "outDir": "dist",
  "rootDir": "src",
  "esModuleInterop": true
}

---

七、总结

步骤	内容	目的
1	安装 Node.js 或 nvm	管理运行时环境
2	配置 npm 源	加速依赖安装
3	初始化项目	生成 package.json
4	编写入口文件	启动服务器
5	配置编辑器与 ESLint	提升开发体验
6	可选启用 TypeScript	增强类型安全

---

八、结语

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

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