Node.js 环境配置

本章节将指导你配置 Node.js 开发环境，包括 Node.js 安装、包管理器配置、开发工具等。

📋 配置清单

• Node.js 安装 (fnm)
• 包管理器配置 (pnpm + bun)
• 全局工具安装
• 项目配置
• 验证安装

1. 安装 Node.js

使用 fnm 安装 (推荐)

macOS/Linux

# 安装 fnm
curl -fsSL https://fnm.vercel.app/install | bash

# 添加到 shell 配置
echo 'eval "$(fnm env --use-on-cd)"' >> ~/.zshrc

# 重新加载配置
source ~/.zshrc

# 安装 LTS 版本
fnm install --lts

# 使用 LTS 版本
fnm use lts-latest

# 设置为默认版本
fnm default lts-latest

Windows

# 使用 Chocolatey 安装 fnm
choco install fnm

# 安装 LTS 版本
fnm install --lts

# 使用 LTS 版本
fnm use lts-latest

# 设置为默认版本
fnm default lts-latest

验证安装

macOS/Linux

# 检查 fnm
fnm --version

# 检查 Node.js
node --version

# 检查 npm
npm --version

Windows

# 检查 fnm
fnm --version

# 检查 Node.js
node --version

# 检查 npm
npm --version

2. 配置包管理器

启用 Corepack (管理 pnpm)

macOS/Linux

# 启用 Corepack
corepack enable

# 准备 pnpm
corepack prepare pnpm@latest --activate

# 配置 pnpm 环境
pnpm setup

Windows

# 启用 Corepack
corepack enable

# 准备 pnpm
corepack prepare pnpm@latest --activate

# 配置 pnpm 环境
pnpm setup

安装 Bun

macOS/Linux

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

# 重新加载配置
source ~/.zshrc

Windows

# 安装 Bun
# 访问: https://bun.sh/
# 下载并安装 Windows 版本

验证包管理器

macOS/Linux

# 检查 pnpm
pnpm --version

# 检查 bun
bun --version

Windows

# 检查 pnpm
pnpm --version

# 检查 bun
bun --version

3. 安装全局工具

安装 nrm (npm 镜像管理)

macOS/Linux

# 安装 nrm
pnpm add -g nrm

# 查看可用镜像
nrm ls

# 切换到淘宝镜像
nrm use taobao

Windows

# 安装 nrm
pnpm add -g nrm

# 查看可用镜像
nrm ls

# 切换到淘宝镜像
nrm use taobao

安装 Whistle (网络代理调试)

macOS/Linux

# 安装 Whistle
pnpm add -g whistle

# 启动 Whistle
w2 start

# 查看 Whistle 状态
w2 status

Windows

# 安装 Whistle
pnpm add -g whistle

# 启动 Whistle
w2 start

# 查看 Whistle 状态
w2 status

4. 项目配置

创建新项目

使用 pnpm

macOS/Linux

# 创建项目目录
mkdir myproject
cd myproject

# 初始化项目
pnpm init

Windows

# 创建项目目录
mkdir myproject
cd myproject

# 初始化项目
pnpm init

使用 Bun

macOS/Linux

# 创建项目目录
mkdir myproject
cd myproject

# 初始化项目
bun init

Windows

# 创建项目目录
mkdir myproject
cd myproject

# 初始化项目
bun init

安装依赖

使用 pnpm

macOS/Linux

# 安装生产依赖
pnpm add express

# 安装开发依赖
pnpm add -D typescript

# 安装所有依赖
pnpm install

Windows

# 安装生产依赖
pnpm add express

# 安装开发依赖
pnpm add -D typescript

# 安装所有依赖
pnpm install

使用 Bun

macOS/Linux

# 安装生产依赖
bun add express

# 安装开发依赖
bun add -d typescript

# 安装所有依赖
bun install

Windows

# 安装生产依赖
bun add express

# 安装开发依赖
bun add -d typescript

# 安装所有依赖
bun install

5. 环境变量配置

创建 .env 文件

macOS/Linux

# 创建 .env 文件
touch .env

# 创建 .env.example 文件
touch .env.example

Windows

# 创建 .env 文件
New-Item -Path .env -ItemType File

# 创建 .env.example 文件
New-Item -Path .env.example -ItemType File

安装 dotenv

使用 pnpm

pnpm add dotenv

使用 Bun

bun add dotenv

6. 调试配置

VS Code 调试配置

创建 .vscode/launch.json 文件：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "program": "${workspaceFolder}/index.js",
      "envFile": "${workspaceFolder}/.env"
    },
    {
      "type": "node",
      "request": "launch",
      "name": "Launch with Bun",
      "program": "${workspaceFolder}/index.js",
      "runtimeExecutable": "bun",
      "envFile": "${workspaceFolder}/.env"
    }
  ]
}

7. 性能优化

配置 pnpm 缓存

macOS/Linux

# 查看 pnpm 缓存位置
pnpm store path

# 清理 pnpm 缓存
pnpm store prune

Windows

# 查看 pnpm 缓存位置
pnpm store path

# 清理 pnpm 缓存
pnpm store prune

配置 Bun 缓存

macOS/Linux

# 查看 Bun 缓存位置
bun pm cache

# 清理 Bun 缓存
bun pm cache rm

Windows

# 查看 Bun 缓存位置
bun pm cache

# 清理 Bun 缓存
bun pm cache rm

✅ 验证安装

完成安装后，验证以下工具是否正常工作：

macOS/Linux

# 检查 Node.js
node --version

# 检查 fnm
fnm --version

# 检查 pnpm
pnpm --version

# 检查 bun
bun --version

# 检查 nrm
nrm --version

# 检查 whistle
w2 --version

Windows

# 检查 Node.js
node --version

# 检查 fnm
fnm --version

# 检查 pnpm
pnpm --version

# 检查 bun
bun --version

# 检查 nrm
nrm --version

# 检查 whistle
w2 --version

🎉 下一步

Node.js 环境配置完成后，继续配置其他编程语言环境：

• Python 环境配置
• Go 环境配置
• Java 环境配置
• Rust 环境配置

---

遇到问题？ 查看 问题排查 页面。