nodejs如何配置开发模式和生产模式的环境?

封面图 • 2025-10-10 • nodejs

在 Node.js 项目中，通常会使用 **开发模式（Development）** 和 **生产模式（Production）** 来区分不同的运行环境。这种区分可以帮助我们：

- 在开发时启用调试信息、热重载等功能；
- 在生产时优化性能、禁用调试信息、使用更安全的配置等。

下面是几种常见的配置方式：

---

## ✅ 一、使用 `NODE_ENV` 环境变量

这是最常见的方式，通过设置 `NODE_ENV` 来区分环境。

### 1. 设置环境变量

#### 开发环境：
```bash
export NODE_ENV=development
```

#### 生产环境：
```bash
export NODE_ENV=production
```

或者在启动命令中直接设置（适用于 Linux/macOS）：

```bash
NODE_ENV=development node app.js
NODE_ENV=production node app.js
```

在 Windows 中可以这样设置：

```cmd
set NODE_ENV=development
node app.js
```

---

### 2. 在代码中判断环境

```js
if (process.env.NODE_ENV === 'development') {
  console.log('Running in development mode');
} else if (process.env.NODE_ENV === 'production') {
  console.log('Running in production mode');
}
```

---

## ✅ 二、使用 `.env` 文件（推荐）

你可以使用 [dotenv](https://www.npmjs.com/package/dotenv) 这个库来加载 `.env` 文件中的环境变量。

### 1. 安装 dotenv

```bash
npm install dotenv
```

### 2. 创建 `.env` 文件

```env
# .env.development
NODE_ENV=development
API_URL=https://api.dev.example.com
DEBUG=true

# .env.production
NODE_ENV=production
API_URL=https://api.prod.example.com
DEBUG=false
```

> 注意：`.env` 文件不要提交到版本控制中（如 Git），应添加到 `.gitignore`。

### 3. 在代码中加载环境变量

```js
require('dotenv').config();

console.log(process.env.NODE_ENV); // 输出 development 或 production
console.log(process.env.API_URL);
```

---

## ✅ 三、使用 `cross-env` 跨平台设置环境变量

如果你需要跨平台支持（Windows/Linux/macOS），可以使用 `cross-env`：

```bash
npm install cross-env --save-dev
```

然后在 `package.json` 的 `scripts` 中使用：

```json
"scripts": {
  "start": "node app.js",
  "dev": "cross-env NODE_ENV=development node app.js",
  "prod": "cross-env NODE_ENV=production node app.js"
}
```

运行命令：

```bash
npm run dev   # 开发模式
npm run prod  # 生产模式
```

---

## ✅ 四、根据环境加载不同配置文件

你可以创建不同的配置文件，例如：

```
config/
  - development.js
  - production.js
  - index.js
```

### config/index.js

```js
const env = process.env.NODE_ENV || 'development';

module.exports = require(`./${env}.js`);
```

### config/development.js

```js
module.exports = {
  port: 3000,
  debug: true,
  db: {
    host: 'localhost',
    user: 'dev_user',
    password: 'dev_pass'
  }
};
```

### config/production.js

```js
module.exports = {
  port: 80,
  debug: false,
  db: {
    host: 'prod-db.example.com',
    user: 'prod_user',
    password: 'prod_pass'
  }
};
```

在代码中使用：

```js
const config = require('./config');

console.log(config.port);
```

---

## ✅ 五、使用构建工具（如 Webpack）

如果你使用了 Webpack、Vite、Parcel 等前端构建工具，它们也支持根据环境变量打包不同配置。

例如，在 Webpack 中：

```js
// webpack.config.js
const env = process.env.NODE_ENV;

module.exports = {
  mode: env,
  // 其他配置...
};
```

---

## 总结

| 方法 | 适用场景 | 优点 |
|------|----------|------|
| `NODE_ENV` | 基础环境判断 | 简单易用 |
| `.env` + `dotenv` | 多环境变量管理 | 可维护性强 |
| `cross-env` | 跨平台设置环境变量 | 方便 |
| 配置文件（development/production） | 项目结构清晰 | 易于扩展 |

---

如果你有具体的项目结构或框架（如 Express、NestJS、Vue、React 等），我可以提供更详细的配置示例。欢迎继续提问！