环境配置检查

.env.example 生成

从已有配置生成示例模板,明确选择保留项,并在导出前检查完整内容。

.env.example 生成

.env 原始配置

.env.example 预览

在浏览器内运行,输入只留在内存,不进入网址、遥测或本地历史。

模板选项

赋值:5 · 清空或替换:5 · 保留:0 · 重复:0 · 原注释:2

注释、补充说明和白名单保留值仍可能含有秘密。请逐项检查;工具不保证结果适合直接提交仓库。

交接项目时,同事需要知道该填哪些变量,却不应该拿到你的实际配置。.env.example 生成从清空全部值开始,端口和布尔值也不会自动放行;需要保留的示例值,必须由你逐个指定键名。

简单地逐行删除等号后面的文本,会漏掉引号内的后续多行内容。这里先把每次赋值完整解析,再替换整个值。语法不合法时停止生成,不会把无法识别的原始行混进模板。

为什么使用 .env.example 生成

留下变量清单,移除实际值

.env.example 生成保留键名、顺序以及同名键的每次出现。一个跨越多行的引号值会整体变成空赋值。默认保留原有注释便于理解分组,分享前仍应检查注释,或关闭保留选项。

两份配置保留相同键标记和注释条,右侧原本填满的值槽变为空白。

把例外与说明写清楚

精确白名单可以只保留已检查的 PORT,其他值继续清空。用 KEY=说明补充变量用途,说明会出现在对应声明上方。保留数量显示每次保留的赋值,不会把看起来普通的数字自动认作安全数据。

只有明确选择的一行保留值,其余值槽为空,各项上方增加独立说明条。

决定模板中应该留下什么

01

先理解清空和占位的区别

清空模式保留 KEY=,占位模式写入一个带引号的文本提示。占位符不是有效凭据,也不会让应用自动完成配置。生成只更新预览,不改写左侧原文。

02

按完整键名设置例外

白名单区分大小写,可用逗号或空白分隔。补充说明必须每行一个 KEY=说明,键名不能重复。输入中不存在的键会单独列出,便于发现拼写错误。

03

修改之后重新检查

自动模式等待 350 毫秒后更新。关闭开关后,可用 Ctrl/Cmd + Enter 手动生成。输入或选项变化会取消此前的人工确认;只有最新结果再次勾选确认后,才能复制或下载。

让配置交接保留必要信息

完整处理每次声明

环境变量模板支持 export 前缀、引号值和空赋值。同名键不会折叠,只要列入白名单,其所有声明都保留原值;否则全部替换。这样不会只处理最后生效的一项,却把较早出现的凭据留在示例里。

按需填写占位文本

占位符可以使用 YOUR_VALUE_HERE 或自己的单行提示。序列化时会处理引号与反斜杠,避免这些字符改变赋值结构。空占位符、控制字符和换行会被拒绝,而不是生成额外变量。

保留注释也可以单独关闭

原有整行注释与行尾注释统一保留或移除,空行继续保留。新增说明始终写成注释,即使关闭原注释也能添加。说明来自你的输入,工具不会猜测数据库地址或令牌的实际用途。

导出前需要知道的边界

清空值不等于扫描秘密
所有未列入白名单的值都会替换,不按名称、数字或布尔类型推断敏感程度。注释、补充说明以及白名单保留值仍可能泄露信息,必须人工检查;勾选确认也不构成无秘密保证。
只接受明确的赋值子集
变量名使用英文字母、数字和下划线,不能以数字开头。支持单引号或双引号多行值。非法赋值、未闭合引号、空字符或不支持的语法会阻止导出。输入和输出各限 1 MiB,原文最多包含 10,000 次赋值。
不读取项目上下文
.env.example 生成不会执行表达式、展开变量、扫描代码、合并其他模板或生成密码。白名单内的 ${HOST} 等引用保持字面文本。工具不排序、不去重,换行统一为 LF;实际加载规则仍取决于应用。
说明不会新增变量
每条说明只能占一个物理行,必须对应合法且不重复的键名。它会变成带井号前缀的注释,插入该键每次声明之前。未找到的键会报告,但不会凭空新增一条赋值;不要在说明中写实际密钥。

.env.example 生成常见问题

生成示例时怎样处理变量值?

默认清空所有变量值,包含数字、布尔值、空值和重复声明。只有你写入精确白名单的键保留原值,匹配区分大小写;改用占位模式后,其余键统一使用自定义占位文本。

工具会保存输入的 .env 吗?

本工具在浏览器内存中处理配置,不把输入写入本地历史,也不会发送到服务端。原文、预览和下载文件仍可见,因此分享屏幕或保存文件时,应按其中实际包含的信息处理。

已有注释会保留吗?

默认保留原来的整行注释和行尾注释,关闭保留选项后会移除这些注释,空行仍保留。新增的 KEY=说明不受此开关影响,始终输出为独立注释。原注释可能含有秘密,需要仔细检查。

原值用了引号会影响生成吗?

支持的引号语法会被完整解析,多行内容作为一次赋值整体替换。白名单中的值保留原始引号写法;未闭合引号会报错并阻止生成。.env.example 生成不会尝试猜测或修复不完整的配置。

可以自定义占位符吗?

可以。切到占位符模式,输入非空单行文本。引号和反斜杠会编码为字面内容;换行与控制字符不接受。占位符只是提示,需要使用模板的人按照项目要求替换成实际配置。

配置值或解析规则有疑问?

整理一份可供填写的模板

回到 .env.example 生成,选择确实需要保留的键,检查注释与说明,再把完整预览作为示例交接。