Node.js安装与配置全攻略：一步步搭建JavaScript运行环境

一、Node.js简介与安装前准备

Node.js是一个基于Chrome V8引擎的JavaScript运行环境，允许开发者在服务器端运行JavaScript代码。在开始安装前，建议先了解您的系统配置：

• 操作系统版本：确认您的Windows、macOS或Linux版本
• 系统架构：32位或64位系统
• 磁盘空间：确保有至少200MB可用空间

二、Windows系统安装指南

1. 下载Node.js安装包

访问Node.js官方网站（nodejs.org），下载最新的LTS（长期支持）版本。LTS版本更稳定，适合生产环境使用。

2. 运行安装程序

双击下载的.msi文件，按照安装向导操作：

1. 接受许可协议
2. 选择安装路径（建议使用默认路径）
3. 勾选”Automatically install the necessary tools”选项
4. 点击安装并等待完成

3. 验证安装

打开命令提示符，输入以下命令：

node --version
npm --version

如果显示版本号，说明安装成功。

三、macOS系统安装方法

方法一：使用官方安装包

从Node.js官网下载macOS安装包，双击.pkg文件并按提示完成安装。

方法二：使用Homebrew（推荐）

如果您已安装Homebrew，只需在终端执行：

brew install node

四、Linux系统安装步骤

Ubuntu/Debian系统

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

CentOS/RHEL系统

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

五、环境配置详解

1. 环境变量配置

Node.js安装后会自动配置环境变量，但有时需要手动调整：

• PATH变量：确保包含Node.js的安装路径
• NODE_PATH：设置全局模块的查找路径

2. npm配置优化

npm是Node.js的包管理器，配置优化能提升开发效率：

# 设置淘宝镜像
npm config set registry https://registry.npmmirror.com

# 设置全局安装路径
npm config set prefix ~/.npm-global

六、使用nvm管理Node.js版本

nvm（Node Version Manager）是管理多个Node.js版本的工具：

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

# 安装特定Node.js版本
nvm install 18.0.0
nvm use 18.0.0

七、常见问题与解决方案

1. 权限问题

在Linux/macOS系统中，避免使用sudo安装全局包，建议配置npm使用本地目录：

mkdir ~/.npm-global
npm config set prefix ~/.npm-global

2. 端口占用

如果默认端口被占用，可在启动应用时指定其他端口：

node app.js --port 3001

3. 模块找不到

确保package.json中的依赖已正确安装，或检查NODE_PATH环境变量设置。

八、最佳实践建议

• 始终使用LTS版本进行生产环境部署
• 定期更新Node.js和npm到稳定版本
• 使用package-lock.json确保依赖一致性
• 配置合适的.gitignore文件排除node_modules