从零开始学 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)

  1. 访问官网:
    打开 Node.js 官网(推荐使用 LTS 版本)。

  2. 下载对应平台的安装包:

    • Windows 用户: 下载 .msi 安装包。
    • macOS 用户: 下载 .pkg 安装包。
  3. 安装步骤:

    • 双击下载的安装包文件,然后按照提示一步步进行安装。
    • 安装过程中一般选择默认设置即可。

2.2 使用包管理器安装(适用于 Linux 和 macOS)

在 macOS 上通过 Homebrew 安装
  1. 安装 Homebrew(如果未安装):
    打开终端(Terminal),输入:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    
  2. 安装 Node.js:

    brew install node
    
在 Linux 上(例如 Ubuntu/Debian 系统)使用 apt 安装
  1. 更新包管理器:

    sudo apt update
    
  2. 安装 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}/`);
});

运行步骤

  1. 将上面的代码保存为 server.js 文件。

  2. 打开命令行(或终端),进入保存 server.js 的目录。

  3. 执行以下命令启动服务器:

    node server.js
    
  4. 在命令行中应显示:

    Server running at http://127.0.0.1:3000/
    
  5. 打开浏览器,访问 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>

使用步骤

  1. 将上述代码保存为 index.html 文件。
  2. 确保已启动 server.js(执行 node server.js)。
  3. 使用浏览器打开 index.html 文件:
    • 可直接双击文件(大部分浏览器支持直接打开 HTML 文件),或者使用本地服务器加载。
  4. 页面加载后,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 -vnpm -v 命令验证安装成功。
  • 编写并运行程序: 通过创建 server.js(JavaScript 文件)来编写简单的 HTTP 服务器,并使用浏览器访问验证;同时,还提供了 index.html(HTML 文件)示例,通过客户端 JavaScript 与服务器交互。
  • 直接复制使用: 本文中的代码均标注了文件名和代码类型,初学者可以直接复制代码进行实验,从而更好地理解 Node.js 的安装和运行流程。

通过以上步骤和示例,你可以详细了解如何安装 Node.js,并亲自体验编写和运行 Node.js 程序的全过程。希望这份详细教程对你和其他学习者有所帮助!

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值