Better YAML Formatter 2.4.0

Better YAML Formatter for Visual Studio Code：让YAML格式化更简单

Better YAML Formatter是一款专为Visual Studio Code设计的扩展，旨在为YAML语言提供强大的格式化支持。如果您对内置格式化工具的选项哲学感到沮丧，或者您来自DevOps领域，每天都要处理大量的YAML文件，如Kubernetes、Ansible或Helm模板，并且有自己偏好的YAML风格（例如，不缩进序列元素或其他自定义设置），那么这个扩展就是为您量身打造的。

功能亮点：

• 正确、一致和自定义的YAML格式化：Better YAML Formatter让您的YAML文本格式化得当、风格一致，并支持个性化设置。

观看演示视频：

https://github.com/user-attachments/assets/dfdec44b-221f-436d-9d90-413f0c0effe6

以Kubernetes YAML为例：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
spec:
  selector:
    matchLabels:
      app: nginx
  replicas: 2
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:latest
        ports:
        - containerPort: 80

如您所见，Kubernetes风格的YAML中，序列样式（如containers和ports）没有缩进。每次使用kubectl时，都没有缩进。更不用说一些工具如kustomize要求您这样做。

不幸的是，内置的YAML格式化工具有自己的选项哲学，总是进行缩进，并且拒绝接受此类自定义设置。

这毫无用处。每次编辑YAML文件时，我都必须手动保持样式，否则您将得到一个非习惯性的YAML文件。

这很繁琐。因此，我创建了这个扩展，以简化您的生活。

扩展设置：

Better YAML Formatter提供了以下设置：

• better-yaml.directives：是否应缩进块序列。
• better-yaml.directives：在输出中包含指令。如果为true，至少会始终包含文档开始标记---。如果为false，则从不包含指令或标记。如果为null，则在需要时可能包含指令和标记。
• better-yaml.commentString：更改注释前缀字符串。默认情况下，空注释行保持为空，只包含一个空格的行将替换为#，所有其他行将以#开头。
• better-yaml.lineWidth：最大行宽（设置为0以禁用折叠）。这是一个软限制，因为只有双引号语义允许在单词中间插入换行符。
• better-yaml.flowCollectionPadding：当为true时，将在非空单行流集合的分隔符内添加一个空格的填充。
• better-yaml.documentOptions.version：没有%YAML指令的文档使用的YAML版本。必须是'1.1'或'1.2'。默认为'1.2'。

感谢：

感谢lupengpeng的图标设计。非常棒！

非常感谢以下项目：

• eemeli/yaml

没有它们，就不会有这个扩展。

在整个过程中，我学到了很多，也为它们做了一些贡献。

当然欢迎您的补丁和贡献！