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

烛阴2025-04-16 23:08

一、什么是.env文件？

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

plaintext 复制代码

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

二、准备工作

创建项目

bash 复制代码

mkdir express-env-demo
cd express-env-demo
npm init -y

安装必要的依赖

bash 复制代码

npm install express dotenv

三、配置.env文件

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

plaintext 复制代码

PORT=3000
GREETING=Hello, World!

四、在Express中加载.env配置

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

javascript 复制代码

// 引入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}`);
});

五、运行你的应用

bash 复制代码

node app.js

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

六、环境变量的最佳实践

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