.env 文件生成器
可视化管理环境变量,生成 .env 和 .env.example 文件
点击「添加变量」或选择场景示例开始
场景示例 — 点击「填入」加载常用项目模板
Node.js 应用
PORT、NODE_ENV、DATABASE_URL、JWT_SECRET 等基础变量
Docker Compose 服务
数据库、Redis、消息队列等服务配置
Vite 前端应用
API 地址、功能开关等前端环境变量(VITE_ 前缀)
关于 .env 文件生成器
- .env 文件用于存储应用的环境变量,通过 dotenv 等库在运行时加载,避免将敏感配置硬编码到代码中
- 支持生成 .env.example 文件(将敏感值替换为占位符),可安全提交到 Git 仓库作为配置模板
- 支持变量分组(添加注释行),让配置文件结构更清晰
操作说明
- 点击「添加变量」新增一行,填写键名、值、描述,勾选「敏感」标记密码/密钥类变量
- 点击「添加分组注释」在变量列表中插入注释行(如
# Database) - 右侧 Tab 切换预览 .env 和 .env.example 的内容差异
- 点击场景示例「填入」快速加载常用项目的环境变量模板
注意事项
- .env 文件必须加入 .gitignore,严禁将含真实密码/密钥的 .env 提交到 Git 仓库
- 值中含空格时建议用引号包裹:
KEY="value with spaces" - 值中含
#时必须用引号包裹,否则会被解析为注释 - 所有处理均在浏览器本地完成,不会上传任何数据
环境变量知识详解
.env 文件格式规范
# 注释行(以 # 开头)
KEY=value # 基本格式
KEY="value with spaces" # 含空格的值用引号
KEY='single quotes' # 单引号也支持
KEY="line1\nline2" # 转义字符(部分库支持)
KEY= # 空值
export KEY=value # 部分格式支持 export 前缀
# 不支持的格式(常见错误)
KEY = value # ❌ 等号两侧不能有空格
KEY=value # comment # ❌ 行内注释(部分库不支持)
环境变量安全最佳实践
- 永远不要提交 .env 到 Git:在 .gitignore 中添加
.env和.env.local - 提交 .env.example:包含所有键名但值为占位符,帮助团队成员了解需要配置哪些变量
- 生产环境使用密钥管理服务:如 AWS Secrets Manager、Azure Key Vault、HashiCorp Vault
- 最小权限原则:数据库账号只授予应用所需的最小权限,不使用 root 账号
- 定期轮换密钥:API Key、数据库密码等应定期更换
各框架加载 .env 的方式
| 框架/运行时 | 加载方式 |
|---|---|
| Node.js | require('dotenv').config() 或 node --env-file=.env(v20.6+) |
| Vite(前端) | 自动加载,变量需以 VITE_ 前缀才暴露给客户端 |
| Next.js | 自动加载,NEXT_PUBLIC_ 前缀暴露给客户端 |
| Docker Compose | env_file: .env 或 --env-file .env |
| Python | python-dotenv 库:load_dotenv() |
| .NET | User Secrets 或 DotNetEnv 库 |