从零开始学 Node.js：完整安装与实战指南
下面提供一份详细的教程，介绍如何安装 Node.js，以及安装成功后如何编写和运行一个简单示例程序。文章中会标注好文件名、代码类型（例如：HTML、JavaScript）以及每一步骤的说明，方便初学者直接复制使用并验证运行结果。
目录
1. 前言
2. 安装 Node.js
2.1 官方下载安装包（适用于 Windows 和 macOS）
2.2 使用包管理器安装（适用于 Linux 和 macOS）
在 macOS 上通过 Homebrew 安装
在 Linux 上（例如 Ubuntu/Debian 系统）使用 apt 安装
3. 验证 Node.js 是否安装成功
4. 编写第一个 Node.js 程序
文件名：server.js
运行步骤
5. 使用 HTML 文件调用 Node.js 服务器
文件名：index.html
使用步骤
6. 程序运行结果说明
A. Node.js 服务器程序（server.js）
B. HTML 文件调用服务器（index.html）
7. 小结
1. 前言
Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境，它允许你在服务器端运行 JavaScript。本文旨在帮助大家详细了解 Node.js 的安装过程，并通过实际代码示例验证安装效果。
2. 安装 Node.js
2.1 官方下载安装包（适用于 Windows 和 macOS）
-
访问官网：
打开 Node.js 官网（推荐使用 LTS 版本）。 -
下载对应平台的安装包：
- Windows 用户： 下载
.msi安装包。 - macOS 用户： 下载
.pkg安装包。
- Windows 用户： 下载
-
安装步骤：
- 双击下载的安装包文件，然后按照提示一步步进行安装。
- 安装过程中一般选择默认设置即可。
2.2 使用包管理器安装（适用于 Linux 和 macOS）
在 macOS 上通过 Homebrew 安装
-
安装 Homebrew（如果未安装）：
打开终端（Terminal），输入：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" -
安装 Node.js：
brew install node
在 Linux 上（例如 Ubuntu/Debian 系统）使用 apt 安装
-
更新包管理器：
sudo apt update -
安装 Node.js 及 npm（Node.js 的包管理工具）：
sudo apt install nodejs npm
注：部分 Linux 发行版中提供的 Node.js 版本可能较旧，建议使用 NodeSource 提供的安装脚本。
3. 验证 Node.js 是否安装成功
安装完成后，在命令行/终端中执行以下命令来检查 Node.js 和 npm 的版本：
# 检查 Node.js 版本（JavaScript 运行环境）
node -v
# 检查 npm 版本（包管理工具）
npm -v
如果正确安装，会分别输出 Node.js 和 npm 的版本号，例如：
v16.17.0
8.15.0
4. 编写第一个 Node.js 程序
为了验证安装是否成功，我们编写一个简单的 HTTP 服务器程序。
文件名：server.js
类型：JavaScript 文件
// server.js (JavaScript 文件)
// 该代码使用 Node.js 内置的 http 模块创建了一个简单的 HTTP 服务器
// 引入 http 模块
const http = require('http');
// 定义服务器地址和端口号
const hostname = '127.0.0.1';
const port = 3000;
// 创建 HTTP 服务器
const server = http.createServer((req, res) => {
// 设置响应状态码和头部信息
res.statusCode = 200;
res.setHeader('Content-Type', 'text/plain');
// 返回文本 "Hello, Node.js!"
res.end('Hello, Node.js!\n');
});
// 启动服务器并监听指定的地址和端口
server.listen(port, hostname, () => {
console.log(`Server running at http://${hostname}:${port}/`);
});
运行步骤
-
将上面的代码保存为 server.js 文件。
-
打开命令行（或终端），进入保存 server.js 的目录。
-
执行以下命令启动服务器：
node server.js -
在命令行中应显示：
Server running at http://127.0.0.1:3000/ -
打开浏览器，访问 http://127.0.0.1:3000/，你会看到页面上显示 “Hello, Node.js!”。
5. 使用 HTML 文件调用 Node.js 服务器
为了展示前后端交互，还可以编写一个 HTML 文件，通过客户端 JavaScript 发起请求并显示 Node.js 服务器返回的数据。
文件名：index.html
类型：HTML 文件
<!-- index.html (HTML 文件) -->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<title>Node.js 安装与测试示例</title>
</head>
<body>
<h1>欢迎使用 Node.js</h1>
<!-- 用于显示服务器响应内容 -->
<div id="output">正在加载服务器数据...</div>
<!-- 客户端 JavaScript 代码 -->
<script>
// 使用 fetch API 发送请求到 Node.js 服务器
fetch('http://127.0.0.1:3000')
.then(response => response.text())
.then(data => {
// 将返回的数据写入页面
document.getElementById('output').textContent = data;
})
.catch(error => {
console.error('请求错误：', error);
document.getElementById('output').textContent = '加载失败，请检查服务器是否启动';
});
</script>
</body>
</html>
使用步骤
- 将上述代码保存为 index.html 文件。
- 确保已启动 server.js（执行
node server.js）。 - 使用浏览器打开 index.html 文件：
- 可直接双击文件（大部分浏览器支持直接打开 HTML 文件），或者使用本地服务器加载。
- 页面加载后，
div中会显示 Node.js 服务器返回的 “Hello, Node.js!”；若服务器未启动，则显示 “加载失败，请检查服务器是否启动”。
6. 程序运行结果说明
A. Node.js 服务器程序（server.js）
- 运行命令： 在终端执行
node server.js - 终端输出：
Server running at http://127.0.0.1:3000/ - 浏览器访问结果： 打开 http://127.0.0.1:3000/ 后，页面上显示：
Hello, Node.js!
B. HTML 文件调用服务器（index.html）
- 页面展示：
- 页面标题为 “欢迎使用 Node.js”
- 页面中的
div元素最初显示 “正在加载服务器数据...” - 成功获取数据后，
div中的文本变为 “Hello, Node.js!”
- 错误处理： 如果 Node.js 服务器未启动，则
div会显示 “加载失败，请检查服务器是否启动”
7. 小结
- 安装 Node.js： 无论是通过官网下载安装包还是通过包管理器安装，都能方便地在各平台上安装 Node.js。安装后，使用
node -v和npm -v命令验证安装成功。 - 编写并运行程序： 通过创建 server.js（JavaScript 文件）来编写简单的 HTTP 服务器，并使用浏览器访问验证；同时，还提供了 index.html（HTML 文件）示例，通过客户端 JavaScript 与服务器交互。
- 直接复制使用： 本文中的代码均标注了文件名和代码类型，初学者可以直接复制代码进行实验，从而更好地理解 Node.js 的安装和运行流程。
通过以上步骤和示例，你可以详细了解如何安装 Node.js，并亲自体验编写和运行 Node.js 程序的全过程。希望这份详细教程对你和其他学习者有所帮助！