node.js零基础入门教程：从环境搭建到服务器开发实战案例详解

admin node.js框架教程 2025-10-24 11

是不是很多零基础的朋友想学 Node.js，却被网上的教程吓住了？“听说 Node.js 能做服务器开发，可我连环境都不会搭”“看别人写的代码全是英文命令，一点都看不懂”“跟着教程做，结果运行时报错，根本不知道哪错了”？别慌，Node.js 没那么难，它就是能让 JavaScript 跑在服务器上的工具，零基础也能学会。今天兔子哥就带大家从环境搭建开始，一步步做出自己的第一个服务器，还有实战案例，跟着做就行，一起往下看吧！

先说说：Node.js 到底能做啥？零基础学它有啥用？

很多新手刚接触时，总觉得 Node.js 离自己很远，其实它在实际开发中用处可大了。简单说，Node.js 就是让 JavaScript 不再只能在浏览器里跑，还能在电脑上、服务器上运行，这样前端开发者学了它，就能自己写服务器、做全栈开发了。
咱们日常用的很多功能都靠它：

开发网站后台接口，比如用户登录、商品查询这些功能
搭建简单的服务器，让本地写的网页能被别人访问
处理文件读写，比如批量修改文件名、统计文件内容
做即时聊天功能，比如网页版聊天工具

学前端的小张分享：“以前做网页只能写静态页面，学了 Node.js 后自己搭服务器、写接口，现在能独立做完整的网站了，找工作时机会多了很多。” 所以零基础学 Node.js，不管是想提升技能还是增加就业筹码，都很有用。

环境搭建：3 步搞定 Node.js 安装，新手也不会出错

学 Node.js 第一步就是装环境，别觉得复杂，跟着步骤点鼠标就行，比装软件还简单。

步骤 1：下载 Node.js 安装包

去 Node.js 官网（nodejs.org），点 “Download” 按钮，新手选 “LTS” 版本（长期支持版，更稳定），根据自己的系统选 Windows 或 Mac 版本。别选最新的 “Current” 版本，可能有兼容性问题，LTS 版本足够用了。

步骤 2：安装 Node.js

双击下载好的安装包，一路点 “Next” 就行。注意这步别勾 “Add to PATH”（有些版本会自动勾），如果没勾，安装完要手动配置环境变量（网上搜 “Node.js 环境变量配置” 有详细步骤）。安装路径默认就行，不用改到 C 盘以外，省得后面出问题。

步骤 3：验证是否安装成功

安装完打开命令提示符（Windows 按 Win+R，输入 cmd 回车），输入node -v，如果显示版本号（比如 v18.17.1），说明安装成功；再输入npm -v（npm 是包管理工具，安装 Node.js 时会自带），显示版本号就没问题了。
小张第一次安装时忘了配置环境变量，输入node -v提示 “不是内部命令”，后来按教程加了环境变量就好了。所以安装后一定要验证，有问题早解决。

基础操作：用 Node.js 写第一个程序，Hello World 入门

环境搭好了，咱们写个最简单的程序，感受下 Node.js 怎么运行。

步骤 1：创建 JavaScript 文件

在桌面新建一个文件夹（比如 “node-first”），在里面新建一个文本文件，改名为 “hello.js”（注意后缀是.js，不是.txt）。右键用记事本或 VS Code 打开，输入代码：
javascript

console.log("Hello Node.js！我是零基础学的~");

步骤 2：运行 JavaScript 文件

打开命令提示符，用cd命令进入文件所在的文件夹（比如cd C:\Users\你的用户名\Desktop\node-first），输入node hello.js，回车后会显示 “Hello Node.js！我是零基础学的～”，说明运行成功了！
是不是很简单？这就是 Node.js 的基本用法：写.js 文件，用node 文件名命令运行。和浏览器里的 JavaScript 不同，这里的console.log会在命令提示符里显示，而不是浏览器控制台。

实战案例：搭建第一个 Web 服务器，让别人访问你的网页

学会基础后，咱们做个实用的案例 —— 搭建 Web 服务器，让本地的 HTML 文件能通过浏览器访问。

步骤 1：创建服务器文件

在刚才的文件夹里新建 “server.js” 文件，输入代码：
javascript

// 引入Node.js自带的http模块const http = require('http');// 引入文件系统模块，用来读取HTML文件const fs = require('fs');// 引入路径模块，处理文件路径const path = require('path');// 创建服务器const server = http.createServer((req, res) => {// 设置响应头，告诉浏览器返回的是HTML，编码是UTF-8res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });// 读取当前文件夹里的index.html文件fs.readFile(path.join(__dirname, 'index.html'), (err, data) => {if (err) {// 如果文件不存在，返回404res.writeHead(404);res.end('页面没找到哦~');} else {// 读取成功，返回HTML内容res.end(data);}});});// 服务器在3000端口监听server.listen(3000, () => {console.log('服务器启动啦！在浏览器访问 http://localhost:3000');});

步骤 2：创建 HTML 文件

在同一个文件夹里新建 “index.html” 文件，输入简单的网页内容：
html

DOCTYPE html><html><head><title>我的第一个Node.js服务器title>head><body><h1>Hello！这是用Node.js搭建的服务器~h1><p>我是零基础学的，是不是很厉害？p>body>html>

步骤 3：启动服务器并访问

在命令提示符里进入文件夹，输入node server.js，会显示 “服务器启动啦！在浏览器访问 http://localhost:3000”。打开浏览器输入这个地址，就能看到刚才写的网页了，是不是很有成就感？

避坑指南：新手常踩的 5 个坑，这样解决超简单

1. 运行命令时提示 “Cannot find module”

这是没进入文件所在的文件夹，或者文件名写错了。用cd命令切换到正确的文件夹，确保文件名和命令里的一致（注意大小写，比如 Server.js 和 server.js 不一样）。

2. 浏览器访问服务器提示 “无法访问此网站”

检查服务器是否启动成功，命令提示符里有没有显示 “服务器启动啦”；再看看端口号对不对，代码里是 3000，浏览器里就必须是 3000，别写成 8080 了。

3. 中文显示乱码

在服务器代码的响应头里加charset=utf-8，就像案例里的'Content-Type': 'text/html; charset=utf-8'，这样中文就能正常显示了。

4. 改了代码后没效果

Node.js 不会自动更新代码，改了文件后要在命令提示符里按 Ctrl+C 停止服务器，再重新输入node 文件名启动，新代码才会生效。

5. 安装时选错版本

新手一定要选 LTS 版本，别选 Current 版本。如果安装后有奇怪的错误，卸载后重新装 LTS 版本，大部分问题都能解决。

自问自答：零基础学 Node.js 常见问题

问：必须用 VS Code 写代码吗？记事本行不行？

答：当然行！记事本也能写，但 VS Code 有代码提示、语法高亮，不容易写错，推荐新手用。刚开始用不惯可以先用记事本，熟练后再换 VS Code。

问：学 Node.js 需要先学好 JavaScript 吗？

答：需要！Node.js 是 JavaScript 的运行环境，基本语法和浏览器里的 JavaScript 一样。如果一点 JavaScript 基础都没有，建议先花一周学 JavaScript 基础，再学 Node.js 会更轻松。

问：除了搭服务器，Node.js 还能做啥练手项目？

答：可以试试做命令行工具（比如批量重命名文件）、简单的接口开发（返回 JSON 数据）、读写本地文件（比如统计单词出现次数），这些项目都不难，适合零基础练手。

个人心得：多敲代码少空想，新手也能学好 Node.js

兔子哥刚开始学 Node.js 时，连cd命令都用不明白，切换文件夹要试好几次，但多练几次就熟了。最大的体会是：别光看教程不动手，每个案例都要自己敲代码运行，报错了就按错误提示搜解决方案，慢慢就有经验了。
小张说：“我跟着教程做服务器案例时，因为少写了一个括号报错，查了半小时才发现，现在写代码会特别注意语法细节。” 所以报错不可怕，解决错误的过程就是进步的过程。
希望这篇教程能帮你入门 Node.js，现在就动手搭环境、写程序，看到自己的服务器在浏览器里运行起来，你会觉得之前的担心都是多余的。技术学习没有捷径，多敲多练，你很快就能掌握 Node.js 的基础用法，加油！

标签： nodejs.org 服务器

本文地址： https://www.kfyz.com/nodejs/1396.html