JSON 转 ENV
将 JSON 或 YAML 对象转换为 KEY=value 格式的 .env 行。嵌套键会用你指定的分隔符(例如 __)连接,因此 {"db":{"host":"x"}} 会变为 DB__HOST=x;数组则使用索引。只有在必要时才会为值加引号,以确保文件能由 dotenv 和类似加载器正确读取。
常见问题
嵌套对象如何转换?
路径上的键会使用你选择的分隔符连接,默认是两个下划线。这符合 ASP.NET Core 配置的惯例,也适用于许多从环境变量读取嵌套设置的工具。
如何处理数组?
每个数组项的索引都会作为键的一部分,因此 {"hosts":["a","b"]} 会变为 HOSTS__0=a 和 HOSTS__1=b。
值在什么情况下会加引号?
只包含字母、数字和简单标点的值会按原样写入。包含空格、引号、#、$ 或反斜杠的值会用单引号括起来;包含单引号或换行符的值会用双引号括起来,并将换行符和引号分别转义为 \n 和 \"。
名称中不允许使用的字符会怎样处理?
除字母、数字和下划线以外的字符都会替换为下划线;选择点号作为分隔符时,点号也会保留。以数字开头的名称会加上下划线前缀。
大写和前缀选项有什么作用?
启用大写后,名称会写成 DB__HOST 这样的形式,这是环境变量的常见风格。添加 APP_ 这样的前缀后,每个名称前都会加上该前缀,方便将同一应用的变量归在一起。
null 和布尔值如何写入?
布尔值和数字会以文本形式写入,例如 true 或 5432。null 值会变为空值,例如 KEY=。