Node.js 安装配置完全指南

最新推荐文章于 2025-09-29 17:35:31 发布

原创最新推荐文章于 2025-09-29 17:35:31 发布 · 1.3k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#node.js #npm

Node.js 安装配置完全指南 - 从入门到进阶

概述

本文将详细介绍如何在不同操作系统上安装和配置 Node.js 环境，包括基础安装、环境变量配置、版本管理等进阶内容，适合新手入门和老手参考。

基础知识

Node.js 版本说明

LTS 版本：长期支持版，建议生产环境使用
Current 版本：最新特性版，包含实验性功能
版本号规则：主版本.次版本.修订号（如 18.12.1）

安装前准备

检查系统要求
清理旧版本（如果有）
准备足够的磁盘空间
确保网络连接正常

Windows 安装指南

方法一：官网安装包（推荐新手）

下载安装包
- 访问 Node.js 官网
- 选择 LTS 版本下载 Windows 安装包（.msi 文件）

安装步骤

# 1. 双击安装包
# 2. 勾选接受协议
# 3. 选择安装路径（建议保持默认）
# 4. 选择组件（建议全选）
# 5. 点击安装

验证安装

# 打开命令提示符（CMD）或 PowerShell
node --version
npm --version

方法二：Scoop 包管理器（推荐老手）

安装 Scoop

# 以管理员身份运行 PowerShell
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

安装 Node.js
```
scoop install nodejs-lts
```
更新 Node.js
```
scoop update nodejs-lts
```

macOS 安装指南

方法一：官网安装包

下载安装包
- 访问 Node.js 官网
- 下载 macOS 安装包（.pkg 文件）

安装步骤

# 1. 双击安装包
# 2. 按照安装向导完成安装

方法二：Homebrew（推荐）

安装 Homebrew

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

安装 Node.js
```
brew install node
```
更新 Node.js
```
brew upgrade node
```

Linux 安装指南

Ubuntu/Debian

使用包管理器

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

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

CentOS/RHEL

使用包管理器

# 添加 NodeSource 仓库
curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -

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

环境变量配置

Windows 环境变量

系统变量设置

# 添加以下路径到 Path 变量
C:\Program Files\nodejs\
%USERPROFILE%\AppData\Roaming\npm

配置 npm 全局模块路径

# 创建自定义目录
mkdir C:\dev\nodejs\node_global
mkdir C:\dev\nodejs\node_cache

# 配置 npm
npm config set prefix "C:\dev\nodejs\node_global"
npm config set cache "C:\dev\nodejs\node_cache"

添加到系统变量

# 新建系统变量
NODE_PATH = C:\dev\nodejs\node_global\node_modules

macOS/Linux 环境变量

配置 bash 环境

# 编辑 ~/.bash_profile 或 ~/.zshrc
export PATH=$PATH:/usr/local/bin/node
export PATH=$PATH:/usr/local/bin/npm

配置 npm 全局模块路径

# 创建自定义目录
mkdir -p ~/.npm-global

# 配置 npm
npm config set prefix '~/.npm-global'

更新环境变量

# 添加到 ~/.bash_profile 或 ~/.zshrc
export PATH=~/.npm-global/bin:$PATH

# 使配置生效
source ~/.bash_profile  # 或 source ~/.zshrc

版本管理工具

nvm（推荐）

安装 nvm

# Windows
# 下载 nvm-windows 安装包

# macOS/Linux
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

基本使用

# 安装特定版本
nvm install 16.14.0

# 使用特定版本
nvm use 16.14.0

# 设置默认版本
nvm alias default 16.14.0

# 列出已安装版本
nvm ls

n（仅支持 macOS/Linux）

安装 n
```
npm install -g n
```

基本使用

# 安装最新 LTS 版本
n lts

# 安装特定版本
n 16.14.0

# 切换版本
n

常见问题解决

1. 权限问题

Windows

# 以管理员身份运行 PowerShell
Set-ExecutionPolicy Unrestricted

macOS/Linux

# 修复 npm 权限
sudo chown -R $USER:$GROUP ~/.npm
sudo chown -R $USER:$GROUP ~/.config

2. 网络问题

配置镜像源

# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 查看当前源
npm config get registry

使用代理

# 设置代理
npm config set proxy http://proxy.example.com:8080
npm config set https-proxy http://proxy.example.com:8080

# 取消代理
npm config delete proxy
npm config delete https-proxy

3. 版本冲突

# 清除 npm 缓存
npm cache clean -f

# 重新安装全局包
npm rebuild

进阶技巧

1. npm 配置优化

# 加速安装
npm config set fund false
npm config set audit false

# 自动修复
npm config set auto-fix true

# 并行安装
npm config set maxsockets 50

2. 开发环境配置

创建 .npmrc 文件
```
save-exact=true
package-lock=false
```
创建 .nvmrc 文件
```
v16.14.0
```

3. CI/CD 环境配置

# 设置 CI 环境变量
export CI=true

# 使用 CI 优化配置
npm ci  # 替代 npm install

最佳实践建议

1. 版本选择

生产环境使用 LTS 版本
开发环境可以使用 Current 版本
项目团队统一使用相同版本

2. 安全建议

定期更新到最新的安全补丁版本
使用 npm audit 检查依赖安全性
配置适当的文件权限

3. 性能优化

使用 npm 缓存
配置合适的网络代理
选择就近的镜像源