环境设置

概述

设置合适的开发环境对于 Node.js 开发至关重要。本章将指导您安装 Node.js、NPM 和必要的开发工具。

安装 Node.js

选项 1：官方安装程序（推荐初学者）

1. 访问 nodejs.org
2. 下载 LTS（长期支持）版本
3. 运行安装程序并按照设置向导操作
4. 验证安装：

node --version
npm --version

选项 2：使用 Node 版本管理器 (NVM)

NVM 允许您安装并在多个 Node.js 版本之间切换。

在 macOS/Linux 上：

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

# 重启终端或运行：
source ~/.bashrc

# 安装最新的 LTS Node.js
nvm install --lts
nvm use --lts

在 Windows 上：

# 从 GitHub releases 安装 nvm-windows
# 然后使用 PowerShell：
nvm install lts
nvm use lts

选项 3：使用包管理器

macOS (Homebrew)：

brew install node

Ubuntu/Debian：

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

Windows (Chocolatey)：

choco install nodejs

理解 NPM

NPM（Node 包管理器）与 Node.js 捆绑在一起，具有多种用途：

• 包管理器：安装和管理依赖项
• 脚本运行器：运行在 package.json 中定义的自定义脚本
• 注册表：访问超过 100 万个包

基本 NPM 命令

# 检查 NPM 版本
npm --version

# 初始化新项目
npm init

# 本地安装包
npm install express

# 全局安装包
npm install -g nodemon

# 安装开发依赖
npm install --save-dev jest

# 更新包
npm update

# 列出已安装的包
npm list

必要的开发工具

1. 代码编辑器

Visual Studio Code（推荐）

• 从 code.visualstudio.com 下载
• 安装 Node.js 扩展：
  • Node.js Extension Pack
  • ESLint
  • Prettier
  • REST Client

2. Nodemon（开发服务器）

当文件更改时自动重启您的应用程序：

# 全局安装
npm install -g nodemon

# 代替 node 使用
nodemon app.js

3. Git 版本控制

# 安装 Git
# Windows: 从 git-scm.com 下载
# macOS: brew install git
# Linux: sudo apt install git

# 配置 Git
git config --global user.name "Your Name"
git config --global user.email "your.email@example.com"

项目结构设置

创建您的第一个项目

# 创建项目目录
mkdir my-node-app
cd my-node-app

# 初始化 NPM 项目
npm init -y

# 创建基本文件
touch app.js
touch .gitignore

基本 package.json 结构

{
  "name": "my-node-app",
  "version": "1.0.0",
  "description": "My first Node.js application",
  "main": "app.js",
  "scripts": {
    "start": "node app.js",
    "dev": "nodemon app.js",
    "test": "jest"
  },
  "keywords": ["nodejs", "javascript"],
  "author": "Your Name",
  "license": "MIT",
  "dependencies": {},
  "devDependencies": {}
}

必要的 .gitignore

# 依赖项
node_modules/
npm-debug.log*

# 环境变量
.env
.env.local
.env.production

# 日志
logs/
*.log

# 运行时数据
pids/
*.pid
*.seed

# 覆盖率目录（由 istanbul 等工具使用）
coverage/

# IDE 文件
.vscode/
.idea/
*.swp
*.swo

# 操作系统生成的文件
.DS_Store
Thumbs.db

环境变量

使用 dotenv 包

npm install dotenv

创建 .env 文件：

PORT=3000
DATABASE_URL=mongodb://localhost:27017/myapp
API_KEY=your-secret-api-key

在应用程序中加载：

require('dotenv').config();

const port = process.env.PORT || 3000;
const dbUrl = process.env.DATABASE_URL;

开发工作流设置

1. ESLint（代码检查）

npm install --save-dev eslint
npx eslint --init

2. Prettier（代码格式化）

npm install --save-dev prettier

创建 .prettierrc：

{
  "semi": true,
  "trailingComma": "es5",
  "singleQuote": true,
  "printWidth": 80,
  "tabWidth": 2
}

3. 包脚本

更新 package.json 脚本：

{
  "scripts": {
    "start": "node app.js",
    "dev": "nodemon app.js",
    "test": "jest",
    "lint": "eslint .",
    "format": "prettier --write ."
  }
}

调试设置

VS Code 调试配置

创建 .vscode/launch.json：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "program": "${workspaceFolder}/app.js",
      "env": {
        "NODE_ENV": "development"
      }
    }
  ]
}

Node.js Inspector

# 使用调试器启动
node --inspect app.js

# 或使用 nodemon
nodemon --inspect app.js

验证测试

创建一个简单的测试文件以验证您的设置：

// app.js
console.log('Node.js version:', process.version);
console.log('NPM version:', process.env.npm_version);
console.log('Environment setup complete!');

// 测试异步操作
setTimeout(() => {
  console.log('Async operation working!');
}, 1000);

运行测试：

node app.js

故障排除常见问题

权限问题 (macOS/Linux)

# 修复 NPM 权限
sudo chown -R $(whoami) ~/.npm

路径问题 (Windows)

• 确保 Node.js 已添加到系统 PATH
• 安装后重启命令提示符

版本冲突

# 清除 NPM 缓存
npm cache clean --force

# 如需要，重新安装 Node.js

下一步

现在您的环境已设置完成，我们将在下一章创建您的第一个 Node.js 应用程序。

实践练习

1. 安装 Node.js 并验证安装
2. 使用 npm init 创建新项目
3. 全局安装 nodemon
4. 创建一个简单的 "Hello World" 应用程序
5. 设置 ESLint 和 Prettier

关键要点

• 安装 Node.js 的多种方式（官方安装程序、NVM、包管理器）
• NPM 对于包管理和脚本运行至关重要
• 合适的项目结构和工具提高开发体验
• 环境变量有助于管理配置
• 开发工具如 nodemon、ESLint 和 Prettier 提高生产力