[TOOL] Node.js： JavaScript运行环境安装

官方文档：https://nodejs.org/en/docs/
Grok生成（2025年10月26日21:04:53）
Gemini修订（2025年10月26日21:23:14）

目录

• Node.js 安装与使用流程
  • 1. Node.js 是什么？
  • 2. Node.js 的安装
    • 步骤 1: 检查是否已安装
    • 步骤 2: 下载和安装
      • Windows 系统
      • macOS 系统
      • Linux 系统（以 Ubuntu 为例）
  • 3. Node.js 的基本使用
    • 步骤 1: 创建第一个程序
    • 步骤 2: 了解模块系统
    • 步骤 3: 使用 NPM
    • 步骤 4: 创建简单 Web 服务器
  • 4. 进阶提示
  • 5. 常见问题与排查

Node.js 安装与使用流程

1. Node.js 是什么？

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境。它允许你用 JavaScript 语言编写服务器端代码，而不是只限于浏览器前端。简单来说：

• 为什么学习它？ Node.js 让 JavaScript 成为全栈开发语言（前后端都行），它高效、异步、非阻塞，适合构建 Web 服务器、API、命令行工具等。许多流行框架如 Express.js、React Native 都依赖它。

• 关键特点：

  • 事件驱动和异步 I/O： 像处理浏览器事件一样处理服务器请求，不会卡住程序。

  • NPM（Node Package Manager）： 一个巨大的包管理器，有上百万个开源模块，可以轻松安装别人写的代码。

• 适合初学者吗？ 是的！如果你有 JavaScript 基础，会更容易上手。没有的话，也没问题，我们从头学。

2. Node.js 的安装

Node.js 的安装很简单，通常几分钟搞定。我们分操作系统讲解。推荐安装 LTS（Long Term Support）版本，它稳定可靠。目前（2025 年），最新 LTS 版本可能是 20.x 或更高，你可以检查官网确认。

步骤 1: 检查是否已安装

在命令行（Windows: CMD 或 PowerShell；macOS/Linux: Terminal）输入：

node -v

如果显示版本号（如 v20.10.0），已安装；否则，继续安装。

步骤 2: 下载和安装

去官网下载：https://nodejs.org/。选择 LTS 版本。

Windows 系统

1. 下载 .msi 安装包（推荐） 或 .zip 文件。
2. 双击 .msi 文件，运行安装向导。
   • 选择安装路径（默认 C:\Program Files\nodejs 就好）。
   • 勾选 “Add to PATH” （自动添加环境变量，让命令行能找到 Node.js）。
   • 安装 NPM（默认包含）。
3. 安装完成后，重启命令行，输入 node -v 和 npm -v 检查。
4. 如果用 .zip：解压后，手动添加路径到环境变量（右键“此电脑” > 属性 > 高级系统设置 > 环境变量 > Path > 添加 nodejs\bin 路径）。

macOS 系统

1. 下载 .pkg 安装包。
2. 双击运行，跟着向导安装。
3. 安装后，打开 Terminal，输入 node -v 检查。
   • 如果用 Homebrew（包管理器，推荐给开发者）： 先安装 Homebrew，然后 brew install node。

Linux 系统（以 Ubuntu 为例）

🔥 推荐方法：使用 NVM (Node Version Manager)

NVM 允许您轻松安装、管理和切换多个 Node.js 版本（如 18、20、22），是开发者的首选。

1. 安装 NVM 依赖：

   sudo apt update
   sudo apt install -y curl wget build-essential
   

2. 安装 NVM： 使用 curl 下载并运行安装脚本。

   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
   

   （注：v0.40.3 为当前稳定版本，请以 NVM 官网最新版本为准。）

3. 加载 NVM： 关闭并重新打开终端，或手动执行加载（取决于您的 Shell）：

   source ~/.bashrc  # 或 source ~/.zshrc
   

4. 安装最新 LTS 版本： 使用 NVM 命令安装最新的长期支持版本。

   nvm install --lts
   

5. 验证：

   node -v
   npm -v
   

📦 替代方法：使用 NodeSource APT 仓库

如果只需要系统级安装一个稳定版本，可以使用 NodeSource 提供的官方 APT 仓库。

1. 添加 NodeSource 仓库并安装最新 LTS：

   # 脚本会自动配置最新的 LTS 版本仓库并更新
   curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
   sudo apt install -y nodejs
   

2. 其他发行版（如 CentOS）：用 yum 或类似命令，参考官网的 NodeSource RPM 仓库。

安装后，NPM 会自动安装。NPM 是 Node.js 的“应用商店”，用来安装模块。

提示： 如果安装失败，检查网络或权限（Linux/macOS 可能需 sudo）。官网有详细文档。

3. Node.js 的基本使用

安装好后，我们来运行第一个程序！Node.js 像运行 JavaScript 一样简单。

步骤 1: 创建第一个程序

1. 新建一个文件夹，如 my-node-project。

2. 用编辑器（如 VS Code）创建文件 hello.js，内容：

   
   console.log('Hello, Node.js!');
   
   

3. 打开命令行，进入文件夹：cd my-node-project。

4. 运行：node hello.js。

   • 输出：Hello, Node.js!

这就是 Node.js 的核心：用 node 文件名 执行 JS 文件。

步骤 2: 了解模块系统

Node.js 用模块组织代码。内置模块如 fs（文件系统）、http（创建服务器）。

• 示例：读取文件。创建 readFile.js：

  
  const fs = require('fs');  // 引入 fs 模块
  
  
  
  fs.readFile('example.txt', 'utf8', (err, data) => {
  
    if (err) {
  
      console.error('Error:', err);
  
      return;
  
    }
  
    console.log('File content:', data);
  
  });
  
  

  • 先创建 example.txt 文件，写点内容。

  • 运行 node readFile.js，它异步读取文件（不会阻塞程序）。

步骤 3: 使用 NPM

NPM 是 Node.js 的灵魂。

1. 初始化项目：在项目文件夹运行 npm init -y，生成 package.json 文件（项目配置文件）。

2. 安装模块：例如安装 lodash（一个工具库）。

   • npm install lodash （本地安装）。

   • 这会创建 node_modules 文件夹和更新 package.json。

3. 使用：修改 hello.js：

   
   const _ = require('lodash');
   
   console.log(_.capitalize('hello node.js'));  // 输出: Hello node.js
   
   

4. 全局安装：npm install -g <包名>，如 npm install -g nodemon（自动重启服务器的工具）。

5. 更新/卸载：npm update、npm uninstall <包名>。

提示： NPM 仓库巨大，搜索模块时用 npm search <关键词> 或官网 https://www.npmjs.com/。

步骤 4: 创建简单 Web 服务器

用 http 模块试试。

创建 server.js：

const http = require('http');



const server = http.createServer((req, res) => {

  res.statusCode = 200;

  res.setHeader('Content-Type', 'text/plain');

  res.end('Hello from Node.js server!\n');

});



server.listen(3000, '127.0.0.1', () => {

  console.log('Server running at http://127.0.0.1:3000/');

});

• 运行 node server.js。

• 浏览器访问 http://localhost:3000，看到问候语。

这展示了 Node.js 的服务器能力。进阶可以用 Express.js 框架（npm install express）简化。

4. 进阶提示

• 调试： 用 VS Code 的调试器，或 node --inspect 文件.js + Chrome DevTools。
• 异步编程： 学 Promise、async/await，避免回调地狱。
• 生态： 学 Express.js（Web 框架）、MongoDB（数据库集成）。
• 版本管理： 用 nvm（Node Version Manager） 切换版本：官网 https://github.com/nvm-sh/nvm。
• 实践项目： 建一个 TODO 列表 API，或聊天机器人。

5. 常见问题与排查

• 命令未找到： 检查 PATH 环境变量，重启命令行。
• 权限错误： Linux/macOS 用 sudo，但避免全局安装时用。
• 网络问题： NPM 慢？用镜像：npm config set registry https://registry.npmmirror.com。
• 版本冲突： 用 nvm 管理。
• 错误代码： 搜索错误消息 + "Node.js"，Stack Overflow 很实用。
• 更新 Node.js： 如果使用 NVM，只需运行 nvm install --lts 或 nvm install <新版本号>。如果使用 APT，运行 sudo apt update && sudo apt upgrade nodejs。