01_初识 Node.js 与内置模块-学习笔记

2026 年 4 月 24 日

3669 字

12 分钟

Node.js

初识 Node.js 与内置模块 · 学习笔记

基于 01_初识 Node.js 与内置模块.pdf 整理
适合作为 Node.js 入门与内置模块速查笔记。


1. 课程结构总览

这份 PDF 主要分成四部分:

  1. 初识 Node.js
  2. fs 文件系统模块
  3. path 路径模块
  4. http 模块

如果把它当作第一天的学习路线,可以理解为:

  • 先搞清楚 Node.js 到底是什么
  • 再学会读写文件
  • 再学会处理路径
  • 最后自己手写一个最基础的 Web 服务器

2. 初识 Node.js

2.1 浏览器中的 JavaScript 为什么能运行

JavaScript 能在浏览器中运行,核心原因有两个:

  1. 浏览器内置了 JavaScript 解析引擎
  2. 浏览器提供了运行环境中的内置 API

不同浏览器使用的 JavaScript 引擎不同,例如:

  • Chrome:V8
  • Firefox:OdinMonkey
  • Safari:JSCore
  • IE:Chakra

其中课程特别强调:Chrome 的 V8 引擎性能很好。

2.2 为什么浏览器中的 JavaScript 能操作 DOM / BOM

因为浏览器运行环境内置了很多 Web API,例如:

  • DOM API
  • BOM API
  • Ajax API

所以浏览器中的 JavaScript 才能调用这些能力。

2.3 浏览器中的 JavaScript 运行环境

浏览器运行环境可以理解为:

  • V8 引擎负责解析和执行 JS
  • 浏览器额外提供 DOM、BOM、Canvas、XHR 等内置 API

一个很重要的结论:

内置 API 是由运行环境提供的,只能在所属环境中调用。

这句话很关键,因为后面理解 Node.js 就靠它。


3. Node.js 是什么

3.1 定义

Node.js 官方定义:

Node.js is a JavaScript runtime built on Chrome’s V8 JavaScript engine.

也就是:

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境。

3.2 Node.js 和浏览器运行环境的区别

浏览器是 JavaScript 的前端运行环境。
Node.js 是 JavaScript 的后端运行环境。

Node.js 中也有:

  • V8 引擎
  • JS 内置对象
  • 自己的一套内置 API

例如:

  • fs
  • path
  • http
  • querystring

但 Node.js 没有浏览器提供的 DOM / BOM API。

所以:

  • 在浏览器里能写 document.querySelector()
  • 在 Node.js 里不能直接写它

3.3 Node.js 可以做什么

课程中列举了几个常见用途:

  • 基于 Express 构建 Web 应用
  • 基于 Electron 构建跨平台桌面应用
  • 基于 restify 构建 API 接口服务
  • 读写和操作数据库
  • 创建命令行工具
  • 作为前端工程化基础设施的一部分

一句话概括:

Node.js 让 JavaScript 的能力从浏览器扩展到了服务端和工具链。

3.4 Node.js 的学习路径

课程给出的学习路径非常清晰:

浏览器 JavaScript 学习路径

  • JavaScript 基础语法
  • 浏览器内置 API(DOM / BOM)
  • 第三方库

Node.js 学习路径

  • JavaScript 基础语法
  • Node.js 内置 API 模块(fs、path、http 等)
  • 第三方 API 模块(express、mysql 等)

也就是说:

Node.js 不是重新学一门语言,而是在 JavaScript 基础上学习新的运行环境和 API。


4. Node.js 环境安装与执行 JS

4.1 安装版本的选择

Node.js 官网常见两个版本:

  • LTS:长期稳定版,企业项目推荐
  • Current:新特性尝鲜版,不适合生产环境优先使用

结论:

初学和正式项目,优先安装 LTS。

4.2 查看 Node.js 版本

node -v

4.3 什么是终端

终端(Terminal)是开发者进行命令交互的重要工具。

在 Windows 中,课程提到可以通过:

  • Win + R
  • 输入 cmd

快速打开终端。

4.4 在 Node.js 环境中执行 JavaScript 文件

node 文件路径

例如:

node ./index.js

4.5 常用终端快捷操作

课程中提到这些高频技巧:

  • ↑:快速调出上一条命令
  • Tab:自动补全路径
  • Esc:清空当前输入
  • cls:清空终端

5. fs 文件系统模块

5.1 fs 是什么

fs 是 Node.js 官方提供的文件系统模块,用来操作文件。

它最常见的两类能力就是:

  • 读取文件
  • 写入文件

使用前先导入:

const fs = require('fs')

6. 读取文件:fs.readFile()

6.1 基本语法

fs.readFile(path, encoding, callback)

参数说明:

  • path:文件路径,必选
  • encoding:编码格式,可选
  • callback:读取完成后的回调函数,必选

6.2 常见写法

const fs = require('fs')

fs.readFile('./test.txt', 'utf8', function (err, dataStr) {
  console.log(err)
  console.log(dataStr)
})

6.3 如何判断读取是否成功

核心判断方式:

  • err === null:成功
  • err !== null:失败

更常见的写法是:

const fs = require('fs')

fs.readFile('./test.txt', 'utf8', function (err, dataStr) {
  if (err) {
    console.log('读取文件失败:' + err.message)
    return
  }

  console.log('读取文件成功:' + dataStr)
})

6.4 重点理解

readFile() 是一个异步 API,不会阻塞后续代码执行。


7. 写入文件:fs.writeFile()

7.1 基本语法

fs.writeFile(file, data, encoding, callback)

参数说明:

  • file:文件路径,必选
  • data:要写入的内容,必选
  • encoding:编码格式,可选,默认 utf8
  • callback:写入完成后的回调,必选

7.2 常见写法

const fs = require('fs')

fs.writeFile('./output.txt', 'hello Node.js', 'utf8', function (err) {
  console.log(err)
})

7.3 判断写入是否成功

const fs = require('fs')

fs.writeFile('./output.txt', 'hello Node.js', 'utf8', function (err) {
  if (err) {
    console.log('写入失败:' + err.message)
    return
  }

  console.log('写入成功')
})

7.4 注意点

课程中提到两个关键点:

  1. fs.writeFile() 只能创建文件,不能创建路径
  2. 多次写入同一个文件时,新内容会覆盖旧内容

8. fs 模块练习:成绩整理

课程案例:

把原始成绩文件中的数据整理后,写入新文件。

核心步骤:

  1. 导入 fs
  2. 读取原始文件
  3. 判断读取是否失败
  4. 处理字符串内容
  5. 写入新文件

这个案例想训练的不是复杂算法,而是:

  • 文件读取
  • 字符串处理
  • 文件写入
  • 异步回调流程

一个典型思路可能是:

const fs = require('fs')

fs.readFile('./成绩.txt', 'utf8', function (err, dataStr) {
  if (err) return console.log('读取失败:' + err.message)

  const result = dataStr.split(' ').join('\n')

  fs.writeFile('./成绩-ok.txt', result, 'utf8', function (err) {
    if (err) return console.log('写入失败:' + err.message)
    console.log('成绩整理完成')
  })
})

9. fs 中的路径动态拼接问题

这是第一天特别重要的坑点。

9.1 问题原因

如果你写的是这种相对路径:

'./files/1.txt'

Node.js 在运行时会基于执行 node 命令时所在的目录来拼接路径。

也就是说:

  • 代码文件放在哪儿,不一定决定相对路径解析结果
  • 你从哪个终端目录执行 node,才会影响路径拼接

9.2 直接结论

课程建议:

操作文件时尽量提供完整路径,不要只依赖 ./ 或 ../ 开头的相对路径。

在实际开发中,更常见的做法是配合 __dirname 和 path.join() 来构造绝对路径。

示例:

const fs = require('fs')
const path = require('path')

const filePath = path.join(__dirname, 'files', '1.txt')

fs.readFile(filePath, 'utf8', function (err, dataStr) {
  if (err) return console.log(err.message)
  console.log(dataStr)
})

10. path 路径模块

10.1 path 是什么

path 是 Node.js 官方提供的路径处理模块。

常见作用:

  • 拼接路径
  • 解析文件名
  • 获取扩展名

使用前导入:

const path = require('path')

11. 路径拼接:path.join()

11.1 基本语法

path.join([...paths])

它可以把多个路径片段拼接成一个完整路径。

11.2 示例

const path = require('path')

const p = path.join('/a', '/b/c', '../', './d', 'index.html')
console.log(p)

11.3 为什么推荐 path.join()

课程特别强调:

只要涉及路径拼接,就应该使用 path.join(),不要直接使用 + 拼接字符串。

原因是:

  • 不同系统路径分隔符可能不同
  • path.join() 能自动规范路径
  • 更安全、更稳定、更可维护

12. 获取文件名:path.basename()

12.1 基本语法

path.basename(path, ext)

参数:

  • path:完整路径字符串
  • ext:可选,扩展名

12.2 示例

const path = require('path')

const fpath = '/a/b/c/index.html'

console.log(path.basename(fpath))
// index.html

console.log(path.basename(fpath, '.html'))
// index

12.3 用途

适合从完整路径中提取:

  • 文件名
  • 去掉扩展名后的主文件名

13. 获取扩展名:path.extname()

13.1 基本语法

path.extname(path)

13.2 示例

const path = require('path')

const fpath = '/a/b/c/index.html'
console.log(path.extname(fpath))
// .html

13.3 用途

适合判断文件类型,例如:

  • .html
  • .css
  • .js
  • .json

14. path 综合案例:拆分时钟页面

课程案例:

把一个 index.html 页面拆分成:

  • index.html
  • index.css
  • index.js

并存到指定目录中。

14.1 核心思路

  1. 用正则匹配 HTML 中的 <style> 标签
  2. 用正则匹配 HTML 中的 <script> 标签
  3. 读取原始 HTML 文件
  4. 把 CSS 提取出来写入 index.css
  5. 把 JS 提取出来写入 index.js
  6. 把处理后的 HTML 写入新的 index.html

14.2 这个案例训练了什么

这个案例本质上训练的是多个知识点的串联:

  • fs.readFile()
  • fs.writeFile()
  • 正则表达式
  • 字符串替换
  • 路径处理

14.3 注意事项

课程中特别提醒:

  • writeFile() 不能创建目录
  • 重复写入同名文件会覆盖旧内容

15. http 模块

15.1 http 是什么

http 是 Node.js 官方提供的模块,用来创建 Web 服务器。

使用前导入:

const http = require('http')

15.2 为什么有了 http 模块就能手写服务器

传统上,一台电脑要成为 Web 服务器,通常需要安装:

  • IIS
  • Apache
  • Nginx
  • 等服务器软件

而在 Node.js 中,借助 http 模块,我们可以直接写出一个最基础的服务器程序。

这意味着:

普通电脑 + Node.js + 一点代码 = 最基础的 Web 服务器


16. 服务器相关基础概念

16.1 客户端与服务器

  • 客户端:负责消费资源
  • 服务器:负责提供资源

16.2 IP 地址

IP 地址是网络中每台计算机的唯一标识。

课程中提到:

  • IP 地址通常写成 a.b.c.d
  • 每段是 0 ~ 255

例如:

192.168.1.1

开发时常见两个地址:

  • 127.0.0.1
  • localhost

它们在本机开发测试时通常都表示当前这台电脑。

16.3 域名与 DNS

域名是为了让人更容易记住服务器地址。

例如:

  • 域名更适合人记忆
  • IP 更适合机器定位

DNS(域名服务器)的作用是:

  • 完成域名到 IP 地址的转换

16.4 端口号

端口号可以理解为一台电脑中不同网络服务的“门牌号”。

重点:

  • 一个端口不能同时被多个服务占用
  • 常见 HTTP 默认端口是 80
  • URL 里如果是 80 端口,通常可以省略

17. 创建最基本的 Web 服务器

17.1 基本步骤

课程给出的 4 步非常重要:

  1. 导入 http 模块
  2. 创建 Web 服务器实例
  3. 为服务器绑定 request 事件
  4. 启动服务器

17.2 示例代码

const http = require('http')

const server = http.createServer()

server.on('request', function (req, res) {
  res.end('Hello Node.js server!')
})

server.listen(80, function () {
  console.log('server running at http://127.0.0.1')
})

17.3 req 请求对象

当客户端发来请求时,request 事件会被触发。

通过 req 可以获取与请求相关的信息,例如:

  • 请求 URL
  • 请求方法
  • 请求头等

常见示例:

server.on('request', function (req, res) {
  console.log(req.url)
  console.log(req.method)
})

17.4 res 响应对象

通过 res 可以向客户端返回内容。

最常见的方法:

res.end('响应内容')

18. 解决中文乱码问题

如果服务器响应中文内容出现乱码,需要设置响应头中的编码格式。

典型做法:

res.setHeader('Content-Type', 'text/html; charset=utf-8')
res.end('你好,世界')

这个知识点非常常见,后面做接口和页面响应时还会频繁碰到。


19. 根据不同 URL 响应不同内容

19.1 核心思路

课程给出的实现步骤:

  1. 获取请求的 URL
  2. 默认响应 404 Not found
  3. 如果是 / 或 /index.html,返回首页内容
  4. 如果是 /about.html,返回关于页面内容
  5. 设置 Content-Type
  6. 调用 res.end() 返回结果

19.2 示例代码

const http = require('http')

const server = http.createServer()

server.on('request', function (req, res) {
  const url = req.url
  let content = '<h1>404 Not found!</h1>'

  if (url === '/' || url === '/index.html') {
    content = '<h1>首页</h1>'
  } else if (url === '/about.html') {
    content = '<h1>关于页面</h1>'
  }

  res.setHeader('Content-Type', 'text/html; charset=utf-8')
  res.end(content)
})

server.listen(80, function () {
  console.log('server running at http://127.0.0.1')
})

19.3 这个案例想让你掌握什么

它训练的是最基础的“路由判断”思维:

  • 用户访问不同路径
  • 服务器返回不同资源

这就是后面学 Express 路由的起点。


20. http 案例:实现时钟 Web 服务器

20.1 核心思路

课程中给出的关键思想:

把文件的实际存放路径,映射为每个资源的请求 URL 地址。

20.2 实现步骤

  1. 导入需要的模块
  2. 创建 Web 服务器
  3. 把请求 URL 映射成文件路径
  4. 读取文件内容
  5. 将文件内容响应给客户端
  6. 优化资源请求路径

20.3 本质理解

这个案例其实是在做一件非常重要的事情:

静态资源服务器

也就是:

  • 浏览器请求 HTML / CSS / JS / 图片
  • Node 服务器去磁盘读取对应文件
  • 再把文件内容返回给浏览器

这是理解前后端协作、静态资源托管、服务器响应资源的基础。


21. 本节课核心知识清单

如果只看这一份 PDF,至少要掌握下面这些点:

Node.js 基础

  • Node.js 是基于 V8 的 JavaScript 运行环境
  • Node.js 是后端运行环境,不提供 DOM / BOM
  • Node.js 的学习核心是内置模块 + 第三方模块

fs

  • 会导入 fs
  • 会用 fs.readFile()
  • 会用 fs.writeFile()
  • 会判断回调中的 err
  • 知道路径相对拼接问题

path

  • 会用 path.join()
  • 会用 path.basename()
  • 会用 path.extname()

http

  • 会创建最基本的 Web 服务器
  • 会监听 request 事件
  • 会使用 req / res
  • 会解决中文乱码
  • 会根据 URL 返回不同内容

22. 一页速查表

22.1 导入模块

const fs = require('fs')
const path = require('path')
const http = require('http')

22.2 读取文件

fs.readFile(filePath, 'utf8', (err, dataStr) => {
  if (err) return console.log(err.message)
  console.log(dataStr)
})

22.3 写入文件

fs.writeFile(filePath, 'content', 'utf8', err => {
  if (err) return console.log(err.message)
  console.log('写入成功')
})

22.4 拼接路径

const fullPath = path.join(__dirname, 'files', '1.txt')

22.5 获取文件名与扩展名

path.basename('/a/b/index.html')
path.basename('/a/b/index.html', '.html')
path.extname('/a/b/index.html')

22.6 创建服务器

const server = http.createServer()
server.on('request', (req, res) => {
  res.end('ok')
})
server.listen(80)

23. 学完这节后下一步该怎么学

学完这份 PDF 后,建议顺序是:

  1. 先自己手写 3 遍 fs.readFile() / fs.writeFile()
  2. 再自己写 2 遍 path.join() + __dirname 路径处理
  3. 然后手写一个最基础的 http 服务器
  4. 再实现“根据不同 URL 返回不同页面”
  5. 最后再进入 Express

因为 Express 本质上就是对 Node 原生 http 能力的高级封装。


24. 一句话总结

这份 PDF 的核心目标不是让你会背 API,而是让你建立一个完整认知:

Node.js = JavaScript 的服务端运行环境;先学会操作文件、处理路径、创建服务器,后面学框架才不会空。

01_初识 Node.js 与内置模块-学习笔记
https://blog.yagami.top/blog/nodejs/day1/01_初识-nodejs-与内置模块-学习笔记/
作者
Nekode
发布时间
2026 年 4 月 24 日
许可协议
CC BY-NC-SA 4.0

正在加载评论...

目录

输入关键词开始搜索