Node.js 新手教程:从零开始学习服务器端 JavaScript
一、什么是 Node.js?为什么它很重要?

在我们正式进入学习之前,先来简单介绍一下 Node.js 是什么,以及它能帮我们做什么。
Node.js 是什么?
Node.js(简称 Node)不是一个编程语言,而是一个让我们可以在电脑上运行 JavaScript 代码的工具。你可能听说过 JavaScript 是浏览器中使用的脚本语言,用来控制网页上的动画、按钮点击等功能。但 Node.js 的出现让 JavaScript 不再只局限在浏览器里 —— 它可以让 JavaScript 在电脑本地甚至服务器上运行!
这意味着,我们可以用熟悉的 JavaScript 语法来写后端程序了!比如搭建网站、读取和写入文件、处理数据等等。
Node.js 能用来做什么?
- 搭建 Web 服务器:你可以用 Node.js 来创建自己的网站或 API 接口。
- 处理数据:Node.js 非常适合处理大量实时数据,比如聊天应用或实时天气系统。
- 构建命令行工具:可以制作一些自己用的小工具,比如自动整理文件的脚本。
- 开发后端服务:很多现代的后端项目都会选择使用 Node.js 搭建,因为前后端都可以用 JavaScript 编写,效率高。
总结一下:Node.js 就是让你在浏览器之外的地方也能运行 JavaScript 的工具,并且非常适合做网络相关的工作。
二、环境准备:安装与配置开发环境

在真正开始写代码前,我们需要准备好我们的开发环境。
第一步:安装 Node.js 和 npm
什么是 npm?
npm 全称是 Node Package Manager,它就像是一个“软件商店”,你可以在这里下载各种现成的模块或工具包,来帮助你更快地开发程序。
安装步骤:
- 打开浏览器,访问官网:https://nodejs.org
- 点击 “Download” 下载 LTS 版本(长期支持版,更适合初学者)
- 安装时按默认设置进行即可
- 安装完成后,打开终端(Windows 可使用 CMD 或 PowerShell,Mac 使用 Terminal),输入以下命令确认是否安装成功:
node -v
如果返回类似这样的版本号(如 v18.17.0),说明 Node.js 已经安装好了 ✅
接着输入:
npm -v
如果也返回了版本号,恭喜你,npm 也安装好了 🎉
第二步:安装代码编辑器
推荐使用 Visual Studio Code (VS Code),它是免费、开源而且非常强大的编辑器。
安装步骤:
- 访问 https://code.visualstudio.com/
- 点击 “Download” 并根据你的操作系统下载对应的版本
- 安装时按照提示一步步操作即可完成
✅ VS Code 安装完成后,记得添加几个有用的插件:
- Prettier:自动格式化代码
- ESLint:帮你检查 JS 代码错误
- Node.js 插件(通常 VS Code 自带)
三、核心概念:轻松理解 Node.js 基础知识

下面我们来介绍几个最重要的概念,并搭配简单的代码示例,确保你容易理解。
1. 如何运行 JavaScript 文件?
在浏览器中运行 JavaScript,一般需要写 HTML 页面;但在 Node.js 中,我们可以直接运行 .js 文件。
示例:
新建一个文件夹 my-project,在里面新建一个文件 hello.js,内容如下:
console.log("Hello from Node.js!");
然后打开终端(进入该目录),输入:
node hello.js
你会看到输出:
Hello from Node.js!
✅ 这就是最基本的 Node.js 程序!
2. 模块化编程:require 和 exports
Node.js 支持模块化编程,也就是把代码分成多个小文件,便于管理和复用。
示例:
假设我们有一个工具函数想被多个文件调用。
新建文件 math.js:
function add(a, b) {
return a + b;
}
// 导出这个函数
module.exports = { add };
然后我们在另一个文件 app.js 中引入并使用它:
// 引入 math.js 中的 add 函数
const math = require('./math');
console.log(math.add(3, 5)); // 输出 8
运行方法:
node app.js
输出结果:
8
🎉 这就是模块的基本用法!
3. 内置模块简介
Node.js 自带了很多功能模块,比如 fs(文件系统)、path(路径处理)、http(创建服务器)等。
示例:使用 fs 模块读取文件内容
新建文件 notes.txt,内容随意,例如写着 这是我的笔记内容。
然后新建 readfile.js:
const fs = require('fs');
fs.readFile('notes.txt', 'utf8', function(err, data) {
if (err) throw err;
console.log("文件内容是:", data);
});
执行:
node readfile.js
你会看到终端输出了文件内容 ✔️
四、实战项目:从零搭建一个最简单的 HTTP 服务器

现在我们来做一个小项目:用 Node.js 创建一个最简单的网页服务器!
1. 用 http 模块创建服务器
新建一个文件 server.js,内容如下:
const http = require('http');
const server = http.createServer((req, res) => {
// 设置响应头,告诉浏览器这是一个 HTML 类型的内容
res.writeHead(200, {'Content-Type': 'text/html'});
// 发送响应内容
res.end('<h1>你好,这是我的第一个 Node.js 服务器!</h1>');
});
// 监听端口 3000
server.listen(3000, () => {
console.log('服务器正在运行于 http://localhost:3000/');
});
运行它:
node server.js
打开浏览器,访问地址:http://localhost:3000/
你会看到一个显示欢迎文字的页面 ✅
2. 返回不同的页面内容(扩展)
我们可以进一步让它根据不同请求路径展示不同内容。
修改 server.js:
const http = require('http');
const server = http.createServer((req, res) => {
res.writeHead(200, {'Content-Type': 'text/html'});
if (req.url === '/') {
res.end('<h1>首页</h1>');
} else if (req.url === '/about') {
res.end('<h1>关于页面</h1>');
} else {
res.end('<h1>404 页面未找到</h1>');
}
});
server.listen(3000, () => {
console.log('服务器正在运行于 http://localhost:3000/');
});
现在试试访问 /about 路径看看吧 🎯
五、常见问题解答(FAQ)
下面是一些新手常遇到的问题和解决办法👇
Q1:为什么运行 node 指令时提示命令不存在?
可能是 Node.js 没有正确安装或者没有加入系统环境变量中。
✅ 解决方法:
- Windows 用户建议重新安装,并选择“Add to PATH”选项
- Mac 用户可以尝试使用
brew install node安装
Q2:为什么文件读写时报错说找不到文件?
有可能是你当前运行命令的目录不对,或者文件名拼写错误。
✅ 检查方法:
- 确保你已经进入了正确的文件夹位置(使用
cd命令切换目录) - 检查文件是否存在,名称是否完全一致(包括大小写)
Q3:能不能使用 ES6 的 import 语法?
Node.js 默认使用的是 require 方式导入模块。如果你想用 import,需要将文件保存为 .mjs 后缀,或者在 package.json 中加上 "type": "module"。
✅ 示例:
{
"type": "module"
}
六、学习建议:下一步怎么学?
恭喜你完成了基础学习!接下来你可以朝着这些方向继续深入:
🔹 学习 Express.js 框架
Express 是 Node.js 最流行的一个框架,它可以让你更快速地创建路由、处理请求、管理模板页面。
👉 推荐练习:搭建一个带有注册登录功能的博客系统
🔹 了解 RESTful API 设计
学会如何设计符合规范的接口,对未来的 Web 开发非常重要。
🔹 学会使用 MongoDB / MySQL 数据库
Node.js 结合数据库才是真正的后端能力 💪
🔹 阅读官方文档和社区资源
- Node.js 官方文档:https://nodejs.org/api/
- Node.js 中文手册:https://nodejs.cn/
- GitHub 上有很多 Node.js 免费教程项目可以参考 👨💻
总结
本教程从 Node.js 是什么讲起,再到环境配置、基本概念讲解,最后通过一个小项目实践了如何创建服务器,同时也回答了一些常见的问题。
📌 初学者记住一点:不要怕写错,多动手、多练习就一定能掌握!
如果你跟着这篇教程一步一步走下来,相信你已经迈出了成为一名全栈开发者的第一步 👏👏
祝你在 Node.js 的世界中越走越远,编写出属于你自己的强大应用!🚀

评论 0