本文将详细介绍如何在本地搭建一个高效、可维护的 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（最新功能版）：包含最新特性，适合尝鲜或测试
下载并运行对应操作系统的安装包后，命令行输入以下命令验证安装：
bash
node -v
npm -v你应能看到类似输出：
v20.18.1
10.5.22. 使用 Node 版本管理器（推荐）
在实际项目中，不同项目可能依赖不同版本的 Node.js。 因此推荐使用版本管理工具，如：
macOS / Linux：
bash
# 安装 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 20Windows：
使用 nvm-windows：
powershell
nvm install 20.18.1
nvm use 20.18.1验证版本：
bash
node -v
nvm list✅ 优势：
- 多版本 Node 共存
- 快速切换项目环境
- 更易于 CI/CD 集成
三、配置 npm（包管理工具）
Node.js 自带的 npm 是 JavaScript 生态的核心包管理器。
常见配置：
1. 修改全局镜像源（加速安装）
默认源在国外，安装速度较慢，可以改为国内镜像：
bash
npm config set registry https://registry.npmmirror.com查看是否成功：
bash
npm config get registry2. 安装全局工具
bash
npm install -g yarn pnpm nodemon常用工具说明：
| 工具 | 作用 |
|---|---|
yarn / pnpm |
更快的包管理器 |
nodemon |
自动重启 Node 服务 |
typescript |
TypeScript 支持 |
eslint |
代码规范检查 |
四、创建一个 Node.js 项目
1. 初始化项目
bash
mkdir my-node-app
cd my-node-app
npm init -y这会生成一个基本的 package.json 文件。
2. 创建主文件
bash
touch index.js编辑内容：
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/');
});运行：
bash
node index.js访问 http://localhost:3000 即可看到结果。
五、使用现代化开发工具
1. VS Code 配置
安装推荐扩展：
- ESLint：代码规范检查
- Prettier：自动格式化
- Node.js Extension Pack：常用 Node 工具集成
添加 .vscode/settings.json：
json
{
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.fixAll.eslint": true
}
}2. 使用 .env 管理环境变量
安装 dotenv：
bash
npm install dotenv在项目根目录添加 .env 文件：
ini
PORT=3000修改代码：
js
require('dotenv').config();
const port = process.env.PORT || 3000;六、使用 TypeScript（可选）
现代 Node 项目推荐使用 TypeScript。
bash
npm install -D typescript ts-node @types/node
npx tsc --init修改 tsconfig.json：
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 容器化部署