Question 1

为什么出现「YAMLException: bad indentation of a mapping entry」？

Accepted Answer

YAML 用空格（绝不要用 Tab）缩进，同一层级的所有子键必须缩进一致。最常见的原因是 Tab 与空格混用或缩进差了一格：

# 错误：第二个键少缩一个空格
  server:
    host: example.com
   port: 8080

# 正确
  server:
    host: example.com
    port: 8080

转换器会标出具体出错行号。请把编辑器设置为「插入空格」，并统一用 2 空格缩进。

Question 2

为什么我的「yes」「no」「on」被转成 true / false 了？

Accepted Answer

YAML 1.1 把 yes/no/on/off 视为布尔（Ruby 和 PyYAML 用户尤其容易踩坑）。DevFormatLab 遵循 YAML 1.2，只有 true / false / null 是保留字，因此 feature: yes 会转成 {"feature": "yes"}，而不是 {"feature": true}。

如果你需要布尔，请写 feature: true。如果确实需要字符串 "true"，请加引号：flag: "true"。

Question 3

如何转换多文档的 Kubernetes 清单？

Accepted Answer

把整个文件（含 --- 分隔符）一起粘贴。转换器会解析每个文档并输出 JSON 数组：

apiVersion: v1
  kind: ConfigMap
  ---
  apiVersion: v1
  kind: Service

会变成：

[
    { "apiVersion": "v1", "kind": "ConfigMap" },
    { "apiVersion": "v1", "kind": "Service" }
  ]

非常适合把 kubectl apply -f 的多文档载荷接入只支持 JSON 的流水线。

Question 4

为什么 YAML → JSON 之后大整数精度丢失？

Accepted Answer

JSON 的 number 是 IEEE-754 双精度，超过 2^53（9 007 199 254 740 992）的整数会被静默四舍五入。Twitter snowflake ID、Kafka offset 都是常见受害者。

解决：把数字在 YAML 里加引号，保持为字符串：

id: "1234567890123456789"

转换结果为 {"id": "1234567890123456789"}，消费端再按需解析，可以保留完整精度。

Question 5

如何把 YAML 转换为 Java .properties？

Accepted Answer

把方向选择器切到 YAML → Properties。嵌套对象会变成点路径，数组用 [0]、[1] 下标：

# YAML
  spring:
    datasource:
      url: jdbc:mysql://localhost:3306/app
    profiles:
      - dev
      - test

# .properties 输出
  spring.datasource.url=jdbc:mysql://localhost:3306/app
  spring.profiles[0]=dev
  spring.profiles[1]=test

Properties → YAML 反向亦支持，并且能正确还原 \uXXXX、
、	 转义与反斜杠续行。

Question 6

YAML 的 anchor (&) 与 alias (*) 会被保留吗？

Accepted Answer

会被解析为最终值。例如：

defaults: &defaults { retries: 3 }
  service: { <<: *defaults, name: api }

在 JSON 侧变成 {"defaults": {"retries": 3}, "service": {"retries": 3, "name": "api"}}。JSON 没有共享引用机制，这种展开是预期行为——你得到的是一份自包含的文档。

YAML 转换

什么是 YAML 转换工具？

功能特性

使用步骤

常见问题