.env 文件检查与转换

粘贴 .env 内容,检查重复的键、不合法的变量名、未加引号的空格和空值;和 .env.example 对比找出缺少或多余的变量;再一键转换成 JSON、shell export、docker 参数、Kubernetes ConfigMap / Secret,或者生成去掉真实值的 .env.example。内容只在浏览器本地处理。新建项目的 .env 模板请用 .env 文件生成器。

转换

.env 写法要点

  • 格式:每行一个 KEY=value,等号两边不要有空格;# 开头是注释。变量名习惯用大写字母、数字和下划线,不能以数字开头。
  • 引号:值里有空格、#、引号时用双引号包起来,如 APP_NAME="我的 应用";双引号中的 \n 会被大多数 dotenv 库解析成换行,单引号中的内容原样保留。
  • 不要提交 .env:把 .env 写进 .gitignore,提交去掉真实值的 .env.example 供团队参考;一旦密钥被提交到仓库,删除提交也不够,要立即更换密钥。
  • Kubernetes Secret:data 里的值是 Base64 编码,不是加密,任何能读取 Secret 的人都能解码,生产环境请配合 RBAC 和加密存储使用。

新项目的 .env 模板和随机密钥可以用 .env 文件生成器。

.env 文件检查与转换常见问题

.env 文件检查与转换怎么使用?

左侧粘贴 .env,右侧可选粘贴 .env.example;下方列出问题和建议写法,并统计变量和疑似敏感项;切换转换格式查看结果,勾选“预览时隐藏敏感值”可以在屏幕共享时遮住密码。

怎么把 .env 转成 JSON?

粘贴内容后选择 JSON 标签即可复制。

怎么把 .env 导入 Kubernetes?

选择 K8s Secret 生成 YAML,或者直接执行 kubectl create secret generic 名称 --from-env-file=.env。

.env 等号两边可以有空格吗?

部分 dotenv 库允许,但 docker --env-file 会把空格当作键名或值的一部分,建议不要加。

.env.example 写什么?

写出所有需要的变量名,值留空或填示例值,提交到仓库供团队参考,真实的 .env 不要提交。

.env 文件检查与转换的结果应怎样理解?

按常见 dotenv 规则解析,不支持变量引用展开(如 ${HOME})和跨行的值;敏感变量按名称中的 SECRET、PASSWORD、TOKEN、KEY 等关键词判断。

输入内容会保存或发给外部服务吗?

.env 内容只在浏览器本地处理,不会上传,但仍建议不要在公共电脑上粘贴生产环境密钥。

没有结果或操作失败时先检查什么?

提示“不是 KEY=value 格式”时,检查是否有多行的值或者遗漏了等号;Windows 换行符会自动处理。

相关工具

YAML 格式化与校验 · CRC 校验计算器 · docker run 命令生成器 · GeoJSON 在线查看与校验 · 全部开发工具