Node.js新手教程：从零开始学习服务器端JavaScript

大家好，我是技术团队的培训负责人，带过不少应届生。很多刚毕业的同学告诉我：“我只会写前端，但一听到‘后端’就发怵。” 其实我当初学的时候也一样——以为后端是另一个世界。直到接触了 Node.js，才发现原来用熟悉的 JavaScript 也能写服务器！今天这篇教程，就是为完全零基础的你量身打造的。咱们不讲空理论，全程动手实践，让你亲手跑起第一个“后端”程序。

---

什么是 Node.js？它能做什么？

简单说：Node.js 是一个让 JavaScript 能在电脑（服务器）上运行的工具。

• 前端：你在浏览器里写的 JS，只能操作网页（比如点击按钮弹窗）。
• 后端：用 Node.js 写的 JS，可以读写文件、连接数据库、处理用户登录、返回 API 数据等。

举个例子：你点外卖时，前端负责展示菜单，后端（Node.js）负责查库存、算价格、下单。

---

环境准备：3 步搭建开发环境

第一步：安装 Node.js

1. 打开 https://nodejs.org
2. 下载 LTS 版本（长期支持版，最稳定）
3. 按照安装向导一路“下一步”

✅ 验证是否安装成功：

node -v
npm -v

如果看到类似 v18.17.0 和 9.6.7 的版本号，说明成功！

💡 小贴士：npm 是 Node.js 自带的包管理工具，用来安装第三方代码库（比如 Express）。

第二步：选一个代码编辑器

推荐使用 VS Code（免费、轻量、前端开发者标配）：

• 下载地址：https://code.visualstudio.com

第三步：创建你的项目文件夹

在电脑任意位置新建一个文件夹，比如叫 my-first-node-app，然后用 VS Code 打开它。

---

核心概念：3 个关键词搞懂 Node.js

1. require —— 引入模块

Node.js 把功能拆成一个个“模块”。比如要读文件，就引入 fs 模块：

// 引入内置的文件系统模块
const fs = require('fs');

2. npm init —— 初始化项目

在项目根目录运行：

npm init -y

会生成一个 package.json 文件，记录项目信息和依赖。

3. npm install —— 安装工具包

比如我们要用一个叫 express 的 Web 框架（简化后端开发）：

npm install express

安装后，node_modules 文件夹会自动出现，里面全是第三方代码。

📌 新手注意：不要手动修改 node_modules！所有依赖都通过 npm 管理。

---

实战项目：5 分钟写一个“Hello World”服务器

现在，我们动手写一个能响应 HTTP 请求的小服务器。

步骤 1：创建 server.js

在项目根目录新建文件 server.js，输入以下代码：

// 1. 引入 express
const express = require('express');

// 2. 创建应用实例
const app = express();

// 3. 定义一个路由：当用户访问 '/' 时，返回 "Hello, Node.js!"
app.get('/', (req, res) => {
  res.send('Hello, Node.js! 你刚刚写了一个后端接口！');
});

// 4. 启动服务器，监听 3000 端口
app.listen(3000, () => {
  console.log('服务器已启动！请打开 http://localhost:3000');
});

步骤 2：运行服务器

在终端（VS Code 内置终端即可）运行：

node server.js

你会看到提示：服务器已启动！请打开 http://localhost:3000

步骤 3：打开浏览器验证

在浏览器地址栏输入 http://localhost:3000，页面会显示：

Hello, Node.js! 你刚刚写了一个后端接口！

🎉 恭喜！你已经完成了人生第一个后端程序！

---

进阶实践：添加一个 API 接口

光有首页不够酷，我们再加一个返回 JSON 数据的接口。

修改 server.js，在 app.get('/') 下面添加：

// 新增一个 /api/users 接口
app.get('/api/users', (req, res) => {
  const users = [
    { id: 1, name: '张三' },
    { id: 2, name: '李四' }
  ];
  res.json(users); // 自动设置 Content-Type 为 application/json
});

保存后，重启服务器（按 Ctrl+C 停止，再运行 node server.js）。

然后访问 http://localhost:3000/api/users，你会看到格式化的 JSON 数据！

💡 提示：前端可以用 fetch('/api/users') 获取这些数据，实现前后端分离。

---

把代码上传到 GitHub

作为开发者，代码必须上 GitHub！这是行业标准工具。

操作步骤：

1. 在 GitHub 注册账号
2. 创建一个新仓库，比如叫 my-first-node-app
3. 在本地项目根目录执行：

git init
git add .
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/你的用户名/my-first-node-app.git
git push -u origin main

⚠️ 注意：把 你的用户名 替换成你的真实 GitHub 用户名。

这样，你的第一个后端项目就永久保存在云端了！

---

新手常见问题解答

问题	原因	解决方案
Cannot find module 'express'	没安装 express 或路径错误	确保在项目根目录运行 npm install express
端口被占用（如 3000）	其他程序占用了 3000 端口	改成 app.listen(3001, ...)
修改代码后要重启服务器	Node.js 不会自动重载	安装 nodemon：npm install -g nodemon，然后用 nodemon server.js 启动
中文乱码	编码问题	在 VS Code 右下角确认文件编码是 UTF-8

---

学习建议与避坑指南

✅ 接下来该学什么？

1. 学习 Express 中间件：比如 body-parser 处理 POST 请求
2. 连接数据库：从 SQLite 或 MongoDB 开始
3. 写 RESTful API：规范地设计接口
4. 部署上线：用 Vercel、Render 或阿里云部署你的 Node.js 应用

❌ 新手常踩的坑

• 不要直接提交 node_modules 到 GitHub！
  解决方案：在项目根目录创建 .gitignore 文件，写入 node_modules/

• 不要在代码里写密码或密钥！
  解决方案：用 .env 文件 + dotenv 包管理环境变量

• 不要忽略错误处理！
  示例：

  app.get('/user/:id', (req, res) => {
    const id = req.params.id;
    if (!id) return res.status(400).send('ID is required');
    // ...
  });
  

---

结语

我带过的应届生里，最快上手后端的就是那些敢动手、不怕报错的同学。Node.js 的魅力在于：你用前端熟悉的语言，打开了后端的大门。今天这个 “Hello World” 服务器，就是你全栈之路的第一块砖。

记住：所有复杂的系统，都是从一行 console.log 开始的。

现在，去你的 GitHub 仓库点个 Star 吧！然后试着给 /api/users 加个新增用户的功能——你已经在成为全栈工程师的路上了！

有任何问题？欢迎在评论区留言，我会一一解答。