首页 > 专题 > AI编程 > 文章详情
返回 AI编程

0-Node.js 和 npm 安装完全指南 - Windows 和 Linux 实践教程

2026年02月08日 30 阅读 AI编程

Node.js 和 npm 安装完全指南

概述

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时环境,而 npm(Node Package Manager)是 Node.js 的默认包管理器。本指南提供 Windows 和 Linux 系统下的详细安装步骤,帮助你快速搭建 Node.js 开发环境。

1. 什么是 Node.js 和 npm

Node.js 是一个开源、跨平台的 JavaScript 运行时环境,允许开发者在服务器端运行 JavaScript 代码。

npm 是世界上最大的软件注册表,包含超过 200 万个包,用于共享和复用 JavaScript 代码。

2. Windows 安装方法

方法一：官方安装程序(推荐)

  1. 访问官方下载页面：https://nodejs.org/ 或者直接进入下载页 https://nodejs.org/zh-cn/download

  2. 下载 LTS(长期支持)版本或 Current(最新)版本

  3. 双击下载的安装包(.msi 文件)

  4. 按照安装向导进行安装:

    • 接受许可协议
    • 选择安装路径(默认即可)
    • 选择组件(默认全选,包括 npm)
    • 等待安装完成

  5. 验证安装:
    打开命令提示符CMD（PowerShell会有权限问题）

    node --version
npm --version

方法二：使用 Chocolatey 包管理器

如果已安装 Chocolatey,可以使用以下命令:

# 安装 Node.js LTS 版本
choco install nodejs-lts

# 或安装最新版本
choco install nodejs

方法三：使用 Scoop 包管理器

# 添加 extras 仓库
scoop bucket add extras

# 安装 Node.js
scoop install nodejs

3. Linux 安装方法

方法一：使用 NodeSource 安装脚本(推荐)

支持 Ubuntu、Debian、CentOS、Fedora 等发行版。

Ubuntu/Debian:

# 下载并执行 NodeSource 安装脚本(Node.js 20.x)
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -

# 安装 Node.js 和 npm
sudo apt-get install -y nodejs

# 验证安装
node --version
npm --version

CentOS/RHEL/Fedora:

# 下载并执行 NodeSource 安装脚本(Node.js 20.x)
curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -

# 安装 Node.js 和 npm
sudo yum install -y nodejs
# 或使用 dnf(Fedora)
sudo dnf install -y nodejs

方法二：使用系统包管理器

Ubuntu/Debian:

# 更新包列表
sudo apt update

# 安装 Node.js 和 npm
sudo apt install -y nodejs npm

# 注意: 系统仓库中的版本可能较旧

CentOS/RHEL:

# 安装 EPEL 仓库(如果尚未安装)
sudo yum install -y epel-release

# 安装 Node.js 和 npm
sudo yum install -y nodejs npm

Fedora:

sudo dnf install -y nodejs npm

Arch Linux:

sudo pacman -S nodejs npm

方法三：使用 nvm(Node Version Manager)

nvm 允许在同一系统上管理多个 Node.js 版本。

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

# 加载 nvm(重启终端或执行以下命令)
export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"

# 安装 Node.js 20.x
nvm install 20

# 设置默认版本
nvm use 20
nvm alias default 20

# 验证安装
node --version
npm --version

4. macOS 安装方法

方法一：使用 Homebrew(推荐)

# 安装 Node.js
brew install node

# 验证安装
node --version
npm --version

方法二：使用 nvm

与 Linux 安装方法相同,参见上文。

5. 安装验证

安装完成后,验证 Node.js 和 npm 是否正确安装:

# 检查 Node.js 版本
node --version
# 输出示例: v20.10.0

# 检查 npm 版本
npm --version
# 输出示例: 10.2.3

# 测试运行 JavaScript
node -e "console.log('Hello, Node.js!')"

6. npm 基本使用

6.1 初始化项目

# 创建新目录
mkdir my-project
cd my-project

# 初始化 package.json
npm init -y

6.2 安装包

# 安装生产依赖
npm install express

# 安装开发依赖
npm install --save-dev nodemon

# 全局安装包
npm install -g @angular/cli

6.3 常用命令

# 安装所有依赖
npm install

# 更新包
npm update

# 卸载包
npm uninstall express

# 运行脚本
npm run start
npm test

7. 常见问题解决

7.1 权限错误(EACCES)

问题: 在 Linux/macOS 上全局安装包时出现权限错误。

解决方案:

方法一：更改 npm 默认目录

# 创建全局安装目录
mkdir ~/.npm-global

# 配置 npm 使用新目录
npm config set prefix '~/.npm-global'

# 添加 PATH 环境变量
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

方法二：使用 nvm 安装 Node.js
使用 nvm 安装的 Node.js 会自动处理权限问题。

7.2 npm 命令找不到

问题: 安装 Node.js 后,npm 命令不可用。

解决方案:

  1. 确保 Node.js 安装时选择了 npm 组件
  2. 检查环境变量 PATH 是否包含 npm 路径
  3. 重新安装 Node.js

7.3 版本冲突

问题: 系统已有旧版本 Node.js,需要升级。

解决方案:

使用 nvm(推荐):

# 列出已安装的版本
nvm list

# 安装新版本
nvm install 20

# 切换到新版本
nvm use 20

Windows:
直接下载新版本安装包覆盖安装,或使用 nvm-windows。

7.4 国内镜像加速

问题: npm 安装包速度慢。

解决方案:

使用淘宝镜像:

# 临时使用
npm install express --registry=https://registry.npmmirror.com

# 永久设置
npm config set registry https://registry.npmmirror.com

# 验证设置
npm config get registry

恢复官方镜像:

npm config set registry https://registry.npmjs.org/

8. 替代方案

8.1 使用 npx(无需安装)

npx 允许你运行 npm 包而无需全局安装:

# 创建 React 应用(无需预先安装 create-react-app)
npx create-react-app my-app

# 运行一次性命令
npx cowsay "Hello, World!"

8.2 使用 Yarn 包管理器

Yarn 是 Facebook 开发的替代 npm 的包管理器:

# 使用 npm 安装 Yarn
npm install -g yarn

# 使用 Yarn
yarn init -y
yarn add express
yarn install

8.3 使用 Bun 运行时

Bun 是一个快速的 JavaScript 运行时和包管理器:

# 安装 Bun
curl -fsSL https://bun.sh/install | bash

# 使用 Bun
bun install
bun add express
bun run start

9. 最佳实践

9.1 使用 nvm 管理版本

  • 便于在不同项目间切换 Node.js 版本
  • 避免权限问题
  • 方便升级和回滚

9.2 锁定依赖版本

# 使用 package-lock.json 锁定版本
npm ci

9.3 定期更新

# 检查过期包
npm outdated

# 更新包
npm update

10. 总结

本指南涵盖了 Windows 和 Linux 系统下安装 Node.js 和 npm 的各种方法:

Windows:

  • 官方安装程序(最简单,推荐)
  • Chocolatey/Scoop(适合已使用包管理器的用户)

Linux:

  • NodeSource 脚本(推荐,获取最新版本)
  • 系统包管理器(简单但版本可能较旧)
  • nvm(推荐开发者使用,便于版本管理)

macOS:

  • Homebrew(最简单,推荐)
  • nvm(适合需要多版本管理的开发者)

选择适合你系统和需求的安装方法,开始你的 Node.js 开发之旅吧!

参考资源:

  • Node.js 官方文档: https://nodejs.org/docs/
  • npm 官方文档: https://docs.npmjs.com/
  • nvm GitHub: https://github.com/nvm-sh/nvm
  • NodeSource GitHub: https://github.com/nodesource/distributions
ClaudeOpenCode