nodejs安装及环境配置

# Node.js 安装及环境配置指南

## 一、安装 Node.js

### Windows 系统安装

1. **下载安装包**：
   - 访问 [Node.js 官网](https://nodejs.org/)
   - 推荐下载 LTS (长期支持) 版本
   - 根据系统选择 Windows Installer (.msi) 或 Windows Binary (.zip)

2. **运行安装程序**：
   - 双击下载的 .msi 文件
   - 按照向导完成安装（建议使用默认设置）
   - 安装时会自动添加 Node.js 和 npm 到系统 PATH

3. **验证安装**：
   ```bash
   node -v
   npm -v
   ```
   如果显示版本号，则安装成功

### macOS 系统安装

1. **使用官方安装包**：
   - 从官网下载 macOS 安装包 (.pkg)
   - 双击运行并按照向导安装

2. **使用 Homebrew**（推荐）：
   ```bash
   brew update
   brew install node
   ```

3. **验证安装**：
   ```bash
   node -v
   npm -v
   ```

### Linux 系统安装

1. **使用包管理器**（以 Ubuntu 为例）：
   ```bash
   curl -sL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
   sudo apt-get install -y nodejs
   ```

2. **验证安装**：
   ```bash
   node -v
   npm -v
   ```

## 二、环境配置

### 1. 配置 npm 全局安装路径（可选）

避免使用 sudo 进行全局安装：

```bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
```

将以下内容添加到 `~/.bashrc` 或 `~/.zshrc` 或 `~/.profile` 中：

```bash
export PATH=~/.npm-global/bin:$PATH
```

然后运行：
```bash
source ~/.bashrc  # 或其他对应的 shell 配置文件
```

### 2. 更新 npm 到最新版本

```bash
npm install -g npm@latest
```

### 3. 配置 npm 镜像源（国内用户建议配置）

使用淘宝镜像：

```bash
npm config set registry https://registry.npmmirror.com
```

检查当前源：
```bash
npm config get registry
```

### 4. 安装常用工具

```bash
npm install -g yarn pnpm nrm
```

### 5. 使用 nvm 管理 Node.js 版本（可选但推荐）

nvm (Node Version Manager) 可以方便地切换 Node.js 版本。

**安装 nvm**：

- Windows: [nvm-windows](https://github.com/coreybutler/nvm-windows)
- macOS/Linux:
  ```bash
  curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
  ```

**常用命令**：
```bash
nvm install 18.0.0  # 安装指定版本
nvm use 18.0.0      # 使用指定版本
nvm ls              # 列出已安装版本
nvm ls-remote       # 列出远程可用版本
```

## 三、验证配置

1. 创建测试文件 `test.js`：
   ```javascript
   console.log("Node.js 环境配置成功!");
   ```

2. 运行测试：
   ```bash
   node test.js
   ```

3. 如果看到输出 "Node.js 环境配置成功!"，则说明一切正常。

## 四、常见问题解决

1. **权限问题**：
   - 避免使用 `sudo` 安装 npm 包
   - 按照上述方法配置 npm 全局安装路径

2. **命令未找到**：
   - 检查 Node.js 是否已添加到 PATH
   - 重新打开终端或运行 `source ~/.bashrc`

3. **版本过旧**：
   - 使用 `nvm` 安装最新版本
   - 或使用 `npm install -g npm` 更新 npm

4. **安装速度慢**：
   - 配置国内镜像源
   - 使用 `yarn` 或 `pnpm` 替代 npm

按照以上步骤操作后，你应该已经成功安装并配置好了 Node.js 开发环境。