Node.js 入门：从零开始搭建第一个服务器

引言 / 什么是 Node.js

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境，它允许开发者使用 JavaScript 编写服务器端程序。与传统后端语言（如 PHP、Java）不同，Node.js 采用事件驱动、非阻塞 I/O 模型，使其在处理高并发请求时具有显著优势。无论是构建实时应用、API 服务还是微服务架构，Node.js 都是现代后端开发的热门选择。

本文将通过搭建一个简单的 HTTP 服务器，带你快速入门 Node.js 开发。即使没有编程基础，只要跟随步骤操作，也能在 30 分钟内完成首个服务器的部署。

准备工作

环境要求

• 操作系统：Windows 10+/macOS 10.15+/Linux（推荐 Ubuntu 20.04+）
• 硬件配置：至少 4GB 内存（开发环境）
• 工具准备：文本编辑器（VS Code 推荐）、终端/命令行工具

安装 Node.js

1. 访问 Node.js 官网
2. 下载 LTS（长期支持版）（当前推荐版本 18.x）
3. 运行安装程序，保持默认选项即可
4. 安装完成后验证：

   node -v
   npm -v
   

   应显示类似 v18.16.0 的版本号

提示：如果使用 macOS/Linux，推荐通过 nvm 管理多版本 Node.js。

基础操作 / 创建第一个服务器

步骤一：初始化项目

1. 创建项目文件夹：

   mkdir my-first-server
   cd my-first-server
   

2. 初始化 npm 项目（按提示填写信息或直接回车）：

   npm init -y
   

   生成 package.json 文件

步骤二：编写服务器代码

1. 创建 server.js 文件
2. 输入以下代码：

   const http = require('http');
   
   const hostname = '127.0.0.1';
   const port = 3000;
   
   const server = http.createServer((req, res) => {
     res.statusCode = 200;
     res.setHeader('Content-Type', 'text/plain');
     res.end('Hello, Node.js Server!\n');
   });
   
   server.listen(port, hostname, () => {
     console.log(`服务器运行在 http://${hostname}:${port}/`);
   });
   

代码解析

• require('http')：导入 Node.js 内置 HTTP 模块
• createServer()：创建服务器实例，接收请求处理函数
• req/res：请求/响应对象，分别包含客户端请求信息和服务器响应方法
• listen()：启动服务器监听指定端口

步骤三：运行服务器

1. 启动服务器：

   node server.js
   

2. 终端应显示：

   服务器运行在 http://127.0.0.1:3000/
   

3. 浏览器访问 http://localhost:3000，应看到：

   Hello, Node.js Server!
   

步骤四：停止服务器

在终端按 `Ctrl + C` 终止进程

进阶技巧

1. 处理不同路由

修改 server.js 实现路由功能：

const server = http.createServer((req, res) => {
  if (req.url === '/') {
    res.end('首页');
  } else if (req.url === '/about') {
    res.end('关于我们');
  } else {
    res.statusCode = 404;
    res.end('页面未找到');
  }
});

2. 使用 Express 框架

安装 Express（轻量级 Web 框架）：

npm install express

创建 express-server.js：

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

app.get('/', (req, res) => {
  res.send('Express 服务器已启动');
});

app.listen(port, () => {
  console.log(`服务器运行在 http://localhost:${port}`);
});

3. 返回 JSON 数据

修改响应头返回结构化数据：

app.get('/api/data', (req, res) => {
  res.json({
    name: 'Node.js',
    version: '18.x',
    status: 'running'
  });
});

4. 环境变量配置

1. 安装 dotenv 包：

   npm install dotenv
   

2. 创建 .env 文件：

   PORT=5000
   NODE_ENV=development
   

3. 修改代码：

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

常见问题

Q：端口被占用怎么办？ A：1. 终止占用端口的进程：

# Windows
netstat -ano | findstr :3000
taskkill /PID <PID> /F

# macOS/Linux
lsof -i :3000
kill -9 <PID>

2. 或修改代码中的端口号

Q：如何让服务器在后台运行？ A：使用 pm2 进程管理器：

npm install pm2 -g
pm2 start server.js
pm2 list  # 查看运行状态
pm2 stop server  # 停止服务

Q：访问服务器出现 EADDRINUSE 错误？ A：该错误表示端口已被占用，解决方法同第一个问题。建议开发时使用 3000-5000 范围内的端口。

小结

通过本文，你已掌握：

1. Node.js 环境安装与验证
2. 使用核心 HTTP 模块创建基础服务器
3. 路由处理和响应不同类型数据
4. 使用 Express 简化开发流程
5. 常见问题的解决方法

建议下一步学习：

• 深入理解事件循环机制
• 学习 RESTful API 设计
• 掌握数据库连接（如 MongoDB/MySQL）
• 尝试部署到云服务器（如阿里云/AWS）

Node.js 的生态系统非常丰富，掌握基础后可以通过 npm 探索更多功能模块。持续实践是提升编程能力的最佳途径，现在就开始构建你的第一个完整应用吧！