⚙️ YAML转.env工具

YAML转.env工具能做什么？

YAML转.env工具是一款免费在线工具，能够将YAML格式的配置文件一键转换为dotenv（.env）格式。自动处理嵌套对象的键名扁平化，将database.host转换为DATABASE_HOST。支持自定义分隔符、键名大写、前缀添加、值引号等选项。适合从YAML配置迁移到环境变量配置的场景。所有转换在浏览器本地完成，数据绝不上传服务器。

核心功能

• 嵌套扁平化：自动将多级嵌套的YAML对象扁平化为点分或下划线分隔的环境变量名
• 灵活配置：支持自定义分隔符（下划线/双下划线/连字符）、键名大小写、前缀、值引号等选项
• 多格式输出：支持标准.env格式和Docker Compose的environment格式输出
• 类型处理：正确处理字符串、数字、布尔值、null等YAML数据类型
• 一键导出：复制结果或下载为.env文件，也可生成Docker Compose格式
• 实时预览：修改YAML或选项后实时更新转换结果

使用教程

1. 在输入框中粘贴YAML配置内容，或点击"加载示例"快速体验。

2. 根据需要配置选项：选择分隔符、是否大写键名、是否添加前缀、是否给值加引号。

3. 点击"转换"按钮，结果区域自动显示生成的.env内容。

4. 点击"复制结果"复制到剪贴板，或"下载.env"保存为文件。

5. 如需Docker Compose格式，点击"复制Docker格式"。

应用场景

场景1：开发者配置迁移

从YAML配置文件迁移到环境变量时，用本工具一键转换，避免手动逐个编写环境变量。

场景2：Docker部署配置

将YAML配置转为.env文件，配合docker-compose使用，实现配置与代码分离。

场景3：CI/CD环境变量设置

在GitHub Actions/GitLab CI中需要设置大量环境变量时，从YAML快速生成变量列表。

场景4：多环境配置管理

将不同环境的YAML配置分别转为.env文件，方便在开发/测试/生产环境间切换。

扩展知识

dotenv（.env文件）是一种流行的配置管理方式，由Node.js的dotenv库推广。其核心思想是将配置信息存储在环境变量中，遵循十二因素应用方法论。YAML是一种人类可读的数据序列化格式，广泛用于配置文件（Docker Compose、Kubernetes、CI/CD等）。从YAML转为.env时，嵌套对象需要扁平化处理：通常用下划线连接层级键名，并将所有字母转为大写以符合环境变量命名惯例。例如database.connection.host变为DATABASE_CONNECTION_HOST。需注意.env文件不应提交到版本控制，应添加到.gitignore中。