npm NODE_ENV怎么配置

在Node.js开发中，NODE_ENV 是一个非常重要的环境变量，它通常用于区分应用程序的运行环境（如开发环境、测试环境、生产环境等）。通过合理配置 NODE_ENV，开发者可以在不同的环境中启用或禁用特定的功能，优化性能，以及管理依赖项。本文将详细介绍如何在npm项目中配置 NODE_ENV。

1. 什么是 NODE_ENV？

NODE_ENV 是一个环境变量，用于指定Node.js应用程序的运行环境。常见的取值包括：

• development：开发环境，通常用于本地开发和调试。
• production：生产环境，用于部署到线上服务器。
• test：测试环境，用于运行自动化测试。

不同的环境变量值会影响应用程序的行为。例如，在生产环境中，开发者可能会启用缓存、压缩资源、禁用调试日志等。

2. 如何在命令行中设置 NODE_ENV

在命令行中，可以通过以下方式设置 NODE_ENV：

2.1 在Unix/Linux/MacOS系统中

NODE_ENV=production node app.js

2.2 在Windows系统中

在Windows系统中，设置环境变量的方式略有不同：

set NODE_ENV=production&& node app.js

注意：在Windows中，set 命令与后面的命令之间不能有空格。

3. 在npm脚本中配置 NODE_ENV

在 package.json 文件中，可以通过 scripts 字段来定义npm脚本。在这些脚本中，可以设置 NODE_ENV 变量。

3.1 直接在脚本中设置

{
  "scripts": {
    "start": "NODE_ENV=production node app.js",
    "dev": "NODE_ENV=development node app.js",
    "test": "NODE_ENV=test mocha"
  }
}

3.2 使用 cross-env 跨平台设置

由于不同操作系统设置环境变量的方式不同，为了确保跨平台兼容性，可以使用 cross-env 工具。首先，安装 cross-env：

npm install cross-env --save-dev

然后在 package.json 中配置脚本：

{
  "scripts": {
    "start": "cross-env NODE_ENV=production node app.js",
    "dev": "cross-env NODE_ENV=development node app.js",
    "test": "cross-env NODE_ENV=test mocha"
  }
}

使用 cross-env 可以确保在不同操作系统上都能正确设置 NODE_ENV。

4. 在代码中访问 NODE_ENV

在Node.js应用程序中，可以通过 process.env.NODE_ENV 访问 NODE_ENV 的值。例如：

if (process.env.NODE_ENV === 'production') {
  console.log('Running in production mode');
} else if (process.env.NODE_ENV === 'development') {
  console.log('Running in development mode');
} else if (process.env.NODE_ENV === 'test') {
  console.log('Running in test mode');
} else {
  console.log('NODE_ENV is not set');
}

5. 使用 .env 文件管理环境变量

为了更方便地管理环境变量，可以使用 .env 文件。.env 文件通常位于项目根目录下，用于存储环境变量。

5.1 创建 .env 文件

在项目根目录下创建 .env 文件，并添加以下内容：

NODE_ENV=development
PORT=3000
DATABASE_URL=mongodb://localhost:27017/mydb

5.2 使用 dotenv 加载 .env 文件

首先，安装 dotenv：

npm install dotenv

然后在应用程序的入口文件（如 app.js 或 index.js）中加载 .env 文件：

require('dotenv').config();

console.log('NODE_ENV:', process.env.NODE_ENV);
console.log('PORT:', process.env.PORT);
console.log('DATABASE_URL:', process.env.DATABASE_URL);

这样，.env 文件中的环境变量就会被加载到 process.env 中。

6. 在Docker中配置 NODE_ENV

在使用Docker部署Node.js应用程序时，可以通过Dockerfile或 docker-compose.yml 文件来设置 NODE_ENV。

6.1 在Dockerfile中设置

FROM node:14

WORKDIR /app

COPY package*.json ./

RUN npm install

COPY . .

ENV NODE_ENV=production

CMD ["node", "app.js"]

6.2 在 docker-compose.yml 中设置

version: '3'
services:
  app:
    image: node:14
    working_dir: /app
    environment:
      - NODE_ENV=production
    volumes:
      - .:/app
    command: node app.js

7. 总结

NODE_ENV 是Node.js开发中一个非常重要的环境变量，合理配置它可以显著提高开发效率和应用程序的性能。本文介绍了如何在命令行、npm脚本、代码、.env 文件以及Docker中配置 NODE_ENV。希望这些内容能帮助你在不同的开发环境中更好地管理Node.js应用程序。