零基础必看!Express 项目 .env 配置,开发、测试、生产环境轻松搞定!

761 阅读1分钟

一、什么是.env文件?

.env文件是一种存放环境变量的文本文件,通常用于存储敏感信息或不同环境(开发、测试、生产)的配置参数。它的内容格式简单,格式为KEY=VALUE,支持注释(以#开头)类似于:

PORT=3000
DB_HOST=localhost
DB_USER=root
DB_PASS=your_password
API_KEY=your_api_key

二、准备工作

  1. 创建项目
mkdir express-env-demo
cd express-env-demo
npm init -y
  1. 安装必要的依赖
npm install express dotenv

三、配置.env文件

在项目根目录下新建一个.env文件,内容示例:

PORT=3000
GREETING=Hello, World!

四、在Express中加载.env配置

app.js中引入dotenv模块,并在应用启动前加载配置。

// 引入dotenv,加载.env文件中的配置
require('dotenv').config();

const express = require('express');
const app = express();

// 使用环境变量
const port = process.env.PORT || 3000;
const greeting = process.env.GREETING || 'Hello';

app.get('/', (req, res) => {
  res.send(greeting);
});

app.listen(port, () => {
  console.log(`服务器已启动,端口:${port}`);
});

五、运行你的应用

node app.js

访问http://localhost:3000,你会看到.env中配置的问候语。

六、环境变量的最佳实践

  • 不要将.env文件提交到版本控制系统:在.gitignore中添加.env,确保敏感信息不泄露。
  • 为不同环境创建不同的配置文件:如.env.development.env.production,并在部署时加载对应的文件。
  • 使用环境变量管理工具:如dotenv-cli,方便在不同环境中切换配置。