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

调皮猴
2025-06-24 09:19
阅读 334

一、什么是 Node.js?为什么它很重要?

一、什么是 Node.js?为什么它很重要?

在我们正式进入学习之前,先来简单介绍一下 Node.js 是什么,以及它能帮我们做什么。

Node.js 是什么?

Node.js(简称 Node)不是一个编程语言,而是一个让我们可以在电脑上运行 JavaScript 代码的工具。你可能听说过 JavaScript 是浏览器中使用的脚本语言,用来控制网页上的动画、按钮点击等功能。但 Node.js 的出现让 JavaScript 不再只局限在浏览器里 —— 它可以让 JavaScript 在电脑本地甚至服务器上运行!

这意味着,我们可以用熟悉的 JavaScript 语法来写后端程序了!比如搭建网站、读取和写入文件、处理数据等等。

Node.js 能用来做什么?

  1. 搭建 Web 服务器:你可以用 Node.js 来创建自己的网站或 API 接口。
  2. 处理数据:Node.js 非常适合处理大量实时数据,比如聊天应用或实时天气系统。
  3. 构建命令行工具:可以制作一些自己用的小工具,比如自动整理文件的脚本。
  4. 开发后端服务:很多现代的后端项目都会选择使用 Node.js 搭建,因为前后端都可以用 JavaScript 编写,效率高。

总结一下:Node.js 就是让你在浏览器之外的地方也能运行 JavaScript 的工具,并且非常适合做网络相关的工作


二、环境准备:安装与配置开发环境

二、环境准备:安装与配置开发环境

在真正开始写代码前,我们需要准备好我们的开发环境。

第一步:安装 Node.js 和 npm

什么是 npm?

npm 全称是 Node Package Manager,它就像是一个“软件商店”,你可以在这里下载各种现成的模块或工具包,来帮助你更快地开发程序。

安装步骤:

  1. 打开浏览器,访问官网:https://nodejs.org
  2. 点击 “Download” 下载 LTS 版本(长期支持版,更适合初学者)
  3. 安装时按默认设置进行即可
  4. 安装完成后,打开终端(Windows 可使用 CMD 或 PowerShell,Mac 使用 Terminal),输入以下命令确认是否安装成功:
node -v

如果返回类似这样的版本号(如 v18.17.0),说明 Node.js 已经安装好了 ✅

接着输入:

npm -v

如果也返回了版本号,恭喜你,npm 也安装好了 🎉


第二步:安装代码编辑器

推荐使用 Visual Studio Code (VS Code),它是免费、开源而且非常强大的编辑器。

安装步骤:

  1. 访问 https://code.visualstudio.com/
  2. 点击 “Download” 并根据你的操作系统下载对应的版本
  3. 安装时按照提示一步步操作即可完成

✅ VS Code 安装完成后,记得添加几个有用的插件:

  • Prettier:自动格式化代码
  • ESLint:帮你检查 JS 代码错误
  • Node.js 插件(通常 VS Code 自带)

三、核心概念:轻松理解 Node.js 基础知识

三、核心概念:轻松理解 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 服务器

四、实战项目:从零搭建一个最简单的 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 是什么讲起,再到环境配置、基本概念讲解,最后通过一个小项目实践了如何创建服务器,同时也回答了一些常见的问题。

📌 初学者记住一点:不要怕写错,多动手、多练习就一定能掌握!

如果你跟着这篇教程一步一步走下来,相信你已经迈出了成为一名全栈开发者的第一步 👏👏

祝你在 Node.js 的世界中越走越远,编写出属于你自己的强大应用!🚀

评论 0

最热最新
暂无评论
匿名用户Lv.1
0
影响力
0
文章
0
粉丝