UD5工具箱
第一步：访问工具页面
打开浏览器，访问 OpenAPI/YAML 规范校验器 工具页面。页面加载后，您将看到左右分栏的界面布局：左侧是 YAML 编辑器区域，右侧是校验结果和统计信息面板。编辑器中默认显示提示文本，等待您输入内容。
第二步：输入 YAML 内容
您可以通过三种方式将 OpenAPI 规范内容输入到编辑器中：第一种是直接在编辑器中粘贴 YAML 文本，这是最常用的方式，适合从其他编辑器或文档中复制内容；第二种是点击工具栏中的"上传"按钮，从本地文件系统选择一个 .yaml 或 .yml 格式的文件，文件内容会自动填充到编辑器；第三种是将 YAML 文件直接从文件管理器拖放到编辑器区域，同样可以自动导入文件内容。如果您是初次使用，可以点击工具栏中的"示例 Petstore（3.0）"按钮，加载一份标准的 OpenAPI 3.0 示例规范进行体验。
第三步：查看实时校验结果
当 YAML 内容输入编辑器后，校验引擎会自动运行，无需手动点击任何按钮。右侧校验面板会立即显示校验结果，包括顶部的统计概览（错误数、警告数、路径数）和下方的详细问题列表。每条问题都标注了严重级别（错误或警告）、问题描述和所在行号。如果规范文件完全合规，面板将显示"无错误"的绿色提示。校验是实时的，每当您修改编辑器中的内容，结果都会自动更新。
第四步：定位并修复错误
当校验发现错误时，您可以点击右侧问题列表中的任意一条错误条目，编辑器会自动滚动到对应的行并高亮显示错误位置。仔细阅读错误描述，了解问题的具体原因（如缺少必填字段、缩进错误、数据类型不匹配等），然后在编辑器中直接修改 YAML 内容。修改完成后，校验引擎会重新运行，实时反映修复效果。如果错误已被修复，对应的条目会从列表中消失；如果修改引入了新的问题，新问题会立即出现在列表中。通过这种"修改-校验-反馈"的循环，您可以高效地将规范文件调整到完全合规的状态。
第五步：格式化 YAML 代码
当您完成了错误修复，或者接手了一份缩进混乱的 YAML 文件时，可以使用工具栏中的"格式化"按钮对编辑器中的代码进行一键整理。格式化操作会按照标准 YAML 规范重新排列缩进和空格，使代码结构清晰、风格统一。需要注意的是，格式化过程会移除 YAML 文件中的注释内容，因为 YAML 注释在解析过程中无法被保留。建议在格式化前备份包含重要注释的文件，或者在格式化后重新添加注释。格式化完成后，校验引擎会自动重新校验格式化后的代码。
第六步：使用含错示例学习
点击工具栏中的"含错示例"按钮，编辑器将加载一份故意包含常见 OpenAPI 规范错误的 YAML 文件。这份示例涵盖了缩进错误、必填字段缺失、引用路径无效、数据类型不匹配等多种典型问题。通过查看校验引擎对这些错误的检测和提示方式，您可以直观地了解工具的校验能力和错误报告格式，这对于理解工具的工作机制和提升自身的 OpenAPI 规范编写技能都非常有帮助。您也可以在含错示例的基础上进行修改，观察校验结果的实时变化，加深对规范要求的理解。
第七步：清除内容并重新开始
当您完成当前文件的校验工作，需要校验新的规范文件时，可以点击工具栏中的"清除内容"按钮，一键清空编辑器中的所有内容。清除后，校验面板会恢复到初始状态，统计数字归零，问题列表清空。此时您可以按照第二步的方式重新输入新的 YAML 内容，开始新一轮的校验工作。整个工具无需保存状态，每次使用都是独立的会话，确保不同文件之间的内容不会相互干扰。