实现 YAML 转 TOML 工具

分类：developer ｜ 标签：YAML、TOML、配置 YAML 配置转 TOML

2.1 功能说明

YAML 配置转 TOML

2.1.1 使用指南

将 YAML 配置转换为 TOML。

• 根必须为映射（对象），顶层序列无法转为 TOML 会提示错误。
• 多文档 YAML 仅转换第一个文档。

2.2 代码实现

2.2.1 组件结构

本工具是一个基于 Vue 3 <script setup> 语法的单文件组件（SFC），统一包裹在 ToolPageShell 组件内，由它提供页面标题、工具 ID、分类与「使用指南」插槽等通用外壳；核心业务逻辑（响应式状态、计算属性、事件处理函数）全部写在 <script setup> 中，输入/输出通过 el-input、el-button 等 Element Plus 组件与用户交互，所有数据均在浏览器本地处理，不会上传服务器。

2.2.2 核心逻辑概览

<script setup> 中定义的主要函数/方法：

• convert()
• copyOut()

2.2.3 关键实现代码

以下是该工具的完整 <script setup> 实现（核心代码）。模板（<template>）与样式（<style>）已省略。

import { ref } from 'vue'
import { ElMessage } from 'element-plus'
import ToolPageShell from '@/components/ToolPageShell.vue'
import { load as yamlLoad, dump as yamlDump } from 'js-yaml'
import { stringify as tomlStringify } from 'smol-toml'

const source = ref('')
const output = ref('')
const error = ref('')

function convert() {
  error.value = ''
  const txt = source.value
  if (!txt || !txt.trim()) {
    error.value = '请输入 YAML'
    return
  }
  let obj
  try {
    obj = yamlLoad(txt)
  } catch (e) {
    error.value = 'YAML 解析失败：' + e.message
    return
  }
  if (Array.isArray(obj)) {
    error.value = 'TOML 不支持顶层数组，请用对象包裹'
    return
  }
  if (obj === null || typeof obj !== 'object') {
    error.value = 'TOML 根必须是对象'
    return
  }
  try {
    output.value = tomlStringify(obj)
  } catch (e) {
    error.value = '转换为 TOML 失败：' + e.message
  }
}

function copyOut() {
  if (!output.value) return
  navigator.clipboard?.writeText(output.value).then(
    () => ElMessage.success('已复制'),
    () => ElMessage.warning('复制失败，请手动选择')
  )
}

2.3 效果截图

工具访问地址：https://www.i91tools.com/tools/yaml-toml