CUE Formatter & Validator

粘贴 CUE 配置并获取一个一致缩进、正确格式化的版本，带行号的语法检查，以及将解析为具体值的每个字段的尽力评估 — 全部在你的浏览器中，不向任何地方上传任何内容。CUE Formatter & Validator 还逐字段显示你的文档哪些部分是固定值，哪些部分仍然是开放约束或模式。

CUE 的约束语法 — 析取 (|)、合取 (&)、界约束 (>=0 & <=100) 和结构化类型 — 不能通过通用 JSON/YAML 格式化程序或 AI 助手对"合理"间距的猜测来干净地往返。此工具直接理解该语法，无需安装 cue CLI。

如何使用

1. 将你的 CUE 源粘贴到输入框中。
2. 可选地在缩进大小之间切换 2 和 4 个空格。
3. 阅读验证表中的任何语法错误（带行号），值 vs. 模式表以查看哪些字段已经是具体的，以及已评估的 JSON 面板以查看解析后的输出。

一切在你输入时自动重新运行。

它做什么

• 格式化结构、列表、定义 (#Foo)、隐藏字段 (_foo)、可选字段 (foo?:)、模式约束标签 ([string]: int) 和 package 子句，按实际嵌套深度重新缩进。注释 (//、前置和尾随) 和空行间距被保留。
• 验证语法并报告第一个问题，带有精确的行号 — 不匹配的括号、未终止的字符串或 CUE 期望的值。
• 评估文字值 (字符串、数字 — 包括十六进制/八进制/二进制和 Ki/Mi/Gi/K/M/G… 大小后缀、布尔值、null、相同的结构和列表) 和简单的 + - * / 算术到它们的具体 JSON 等价物。
• 区分值和模式。 像 port: 8080 这样的字段解析为真实值；像 replicas: >=1 & <=10 或 env: "prod" | "staging" 这样的字段是还没有单一值的约束 — 值 vs. 模式表按字段调用这个 (包括嵌套结构内)，已评估的 JSON 面板用 ⟨constraint: …⟩ 占位符标记它无法解析的任何字段，而不是猜测。

它不做什么

这不是 CUE 统一引擎的重新实现 — 它解决文字值和简单算术，而不是一般约束解决 (#Point & {x: 0, y: 0} 保持约束，因为该工具不合并结构定义)。import 声明、理解 (if/for) 和 let 子句，以及哈希字符串 (#"…"#) 不被支持，并作为语法错误而不是无声处理报告。三引号字符串的常见前置缩进不以真实 cue fmt 的方式删除。

隐私

一切都在你的浏览器中的客户端运行 — 你的配置永远不会上传到服务器。

为什么不直接使用 cue fmt？

如果你安装了 CUE CLI，它是权威格式化程序并进行完整的类型检查。此工具适用于你没有时 — 来自拉取请求的片段、AI 助手使用混乱约束语法生成的配置，或粘贴到 Kubernetes 清单或 Dagger 管道之前的快速检查。

为什么我的字段显示 ⟨constraint: …⟩ 占位符而不是值？

该字段还不是具体的 — 它是析取、界、对另一个字段的引用，或用作模式的 string/int 类型。值 vs. 模式表显示精确的约束文本，所以你可以看到什么仍然开放。

相关工具

• Kubernetes YAML Formatter — 用于 CUE 配置通常编译到的 YAML 清单。
• JSON Schema Validator — 描述和检查 JSON/YAML 数据形状的另一种方式。
• TOML Formatter — 另一种配置语言的相同类型的格式化。