node.js安装教程

Node.js 安装教程

目录

  1. 简介
  2. 下载安装包
  3. 安装步骤
  4. 验证安装
  5. 使用 nvm 管理版本
  6. 第一个 Node.js 程序
  7. 常见问题

简介

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境。本教程将指导您在不同操作系统上安装 Node.js 和 npm（Node Package Manager）。

下载安装包

访问 Node.js 官网 下载最新 LTS 版本（推荐大多数用户使用）。

Node.js 官网下载页面

安装步骤

Windows 系统

  1. 双击下载的 .msi 安装文件
  2. 按照向导步骤操作（建议保持默认配置）
  3. 勾选 **”Automatically install the necessary tools”**（自动安装必要工具）
  4. 完成安装后重启系统

macOS 系统

方法一：官方安装包

  1. 打开下载的 .pkg 文件
  2. 按照安装向导完成安装

方法二：Homebrew

1
brew install node

Linux 系统

Debian/Ubuntu

1
2
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

RHEL/CentOS

1
2
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
sudo yum install nodejs

验证安装

打开终端/命令提示符，执行以下命令：

1
2
3
4
5
node -v
# 应显示版本号，如：v20.12.2

npm -v
# 应显示 npm 版本号，如：10.5.0

使用 nvm 管理版本

推荐使用 nvm（Node Version Manager）进行多版本管理：

  1. 安装 nvm

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

  2. 使用示例

    1
    2
    3
    nvm install 18      # 安装 v18 最新版
    nvm use 20          # 切换至 v20
    nvm ls              # 查看已安装版本

第一个 Node.js 程序

  1. 创建 hello.js 文件：

    1
    console.log("Hello Node.js!");

  2. 运行程序：

    1
    node hello.js

常见问题

Q：命令提示符找不到 node/npm
A：请检查系统环境变量 PATH 是否包含 Node.js 安装路径

Q：权限问题（EACCES）
A：建议使用以下命令修复权限：

1
2
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

Q：如何更新 npm？ 

1
npm install -g npm@latest

官方文档：https://nodejs.org/docs/latest/api/
nvm 仓库：https://github.com/nvm-sh/nvm


此教程包含：
- 多平台安装指南
- 版本管理方案
- 基础验证方法
- 常见问题解决方案
- 格式优化（代码块、目录跳转、图片占位符）

可根据实际需求调整版本号或添加更多系统支持细节。