Node.js 安装配置完全指南

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

概述

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

目录

1. 基础知识
2. Windows 安装指南
3. macOS 安装指南
4. Linux 安装指南
5. 环境变量配置
6. 版本管理工具
7. 常见问题解决
8. 进阶技巧

基础知识

Node.js 版本说明

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

安装前准备

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

Windows 安装指南

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

1. 下载安装包

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

2. 安装步骤

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

3. 验证安装

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

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

1. 安装 Scoop

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

2. 安装 Node.js

   scoop install nodejs-lts
   

3. 更新 Node.js

   scoop update nodejs-lts
   

macOS 安装指南

方法一：官网安装包

1. 下载安装包

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

2. 安装步骤

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

方法二：Homebrew（推荐）

1. 安装 Homebrew

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

2. 安装 Node.js

   brew install node
   

3. 更新 Node.js

   brew upgrade node
   

Linux 安装指南

Ubuntu/Debian

1. 使用包管理器

   # 添加 NodeSource 仓库
   curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
   
   # 安装 Node.js
   sudo apt-get install -y nodejs
   

CentOS/RHEL

1. 使用包管理器

   # 添加 NodeSource 仓库
   curl -fsSL https://rpm.nodesource.com/setup_lts.x | sudo bash -
   
   # 安装 Node.js
   sudo yum install -y nodejs
   

环境变量配置

Windows 环境变量

1. 系统变量设置

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

2. 配置 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"
   

3. 添加到系统变量

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

macOS/Linux 环境变量

1. 配置 bash 环境

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

2. 配置 npm 全局模块路径

   # 创建自定义目录
   mkdir -p ~/.npm-global
   
   # 配置 npm
   npm config set prefix '~/.npm-global'
   

3. 更新环境变量

   # 添加到 ~/.bash_profile 或 ~/.zshrc
   export PATH=~/.npm-global/bin:$PATH
   
   # 使配置生效
   source ~/.bash_profile  # 或 source ~/.zshrc
   

版本管理工具

nvm（推荐）

1. 安装 nvm

   # Windows
   # 下载 nvm-windows 安装包
   
   # macOS/Linux
   curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
   

2. 基本使用

   # 安装特定版本
   nvm install 16.14.0
   
   # 使用特定版本
   nvm use 16.14.0
   
   # 设置默认版本
   nvm alias default 16.14.0
   
   # 列出已安装版本
   nvm ls
   

n（仅支持 macOS/Linux）

1. 安装 n

   npm install -g n
   

2. 基本使用

   # 安装最新 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. 网络问题

1. 配置镜像源

   # 使用淘宝镜像
   npm config set registry https://registry.npmmirror.com
   
   # 查看当前源
   npm config get registry
   

2. 使用代理

   # 设置代理
   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. 开发环境配置

1. 创建 .npmrc 文件

   save-exact=true
   package-lock=false
   

2. 创建 .nvmrc 文件

   v16.14.0
   

3. CI/CD 环境配置

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

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

最佳实践建议

1. 版本选择

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

2. 安全建议

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

3. 性能优化

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