VSCode原生支持OpenAPI预览但不支持“Try it out”，需手动设置语言模式为OpenAPI Specification、配置v3.1 Schema映射，并确保文档含openapi: 3.1.0、info和paths字段，$ref引用文件也须以openapi:开头且用正斜杠路径。
VSCode 原生支持 OpenAPI 预览，但“测试”（即 Try it out）必须靠外部工具补足；不装插件也能预览，但配错 yaml.schemas 或语言模式就全白搭。
怎么让 VSCode 正确识别 openapi.yaml 并显示 Preview 按钮
VSCode 不会自动把 openapi.yaml 当成 OpenAPI 文档——它默认只当普通 YAML。没手动绑定，连高亮都没有。
- 右键文件 → Change Language Mode → 选
OpenAPI Specification（不是YAML或JSON） - 右下角状态栏应显示
OpenAPI Specification；若没显示，点它 → Configure File Association for '.yaml' → 输入openapi确认 - 打开
settings.json，加这条（路径必须是 v3.1，不是 v3.0）："yaml.schemas": { "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/schemas/v3.1/schema.json": ["openapi.yaml"] } - 改完保存，**重新打开文件**，否则校验和预览不生效
为什么点 Preview 只显示 “No OpenAPI definition found”
这不是插件坏了，是文档结构没通过最基础的准入检查。VSCode 的 OpenAPI Editor 会先做静态扫描，失败就拒载。
- 文件开头必须严格是
openapi: 3.1.0（openapi: 3.0.3也行，但swagger:完全不认） -
info和paths是两个必填字段，缺一不可；哪怕空对象也要写：info: {}<br>paths: {} - YAML 缩进错一格，
paths就可能被忽略，预览页直接空白 - 如果用了
$ref，确保被引用文件（如./schemas/user.yaml）第一行也是openapi: 3.1.0
如何在 VSCode 里真正“试请求”（Try it out）
VSCode 内置预览和 OpenAPI (Swagger) Editor 插件都不发真实 HTTP 请求——它们是只读渲染器。要试调，得换路子。
- 装
REST Client插件（官方维护，支持.http文件） - 右键 OpenAPI 定义 → Generate HTTP File（需配合
API Center扩展） - 或手动写
curl/GET块到xxx.http文件里，按Ctrl+Alt+R发请求 - 别指望
Swagger Viewer支持本地服务调用：它不读server.url，也不带认证头，纯 UI 渲染
$ref 跨文件总报 file not found 怎么办
不是路径写错了，是 VSCode 对引用目标有硬性要求——它只认“声明了 OpenAPI 版本号”的 YAML 文件。
- 所有被
$ref引用的文件（如components/schemas/User.yaml）第一行必须是openapi: 3.1.0 - 路径必须用正斜杠
/，写成.\components\schemas\User.yaml必然失败（Windows 也一样） - 不能用
$ref: 'https://...—— VSCode 不发起网络请求，本地开发一律用相对路径 - 检查文件是否真实存在：隐藏后缀（
User.yaml.txt）、大小写（user.yamlvsUser.yaml）在 macOS/Linux 下也会触发 not found
复杂点在于：VSCode 的 OpenAPI 预览能力依赖两层绑定——语言模式 + Schema 映射，漏掉任意一层，$ref、校验、预览全崩；而“测试”这件事，它压根没打算自己干，得靠 REST Client 或后端运行时暴露的 /docs 页面来补位。
