vscode接口文档插件不自带服务端，仅为前端渲染器；需手动配置外部服务（如live-server、springdoc）以支持远程加载、相对路径或跨域请求。
VSCode接口文档插件不自带服务端
绝大多数 VSCode 接口文档类插件（比如 Swagger Viewer、OpenAPI Preview、Redoc Preview）本身是纯前端渲染器，**不包含后端服务**。它们只读取本地或远程的 OpenAPI/Swagger JSON/YAML 文件，解析后在 WebView 中渲染成可交互文档。所谓“服务端设置”，其实是你主动引入的外部服务，而非插件自身提供。
需要服务端时的常见场景和对应配置
当你遇到以下情况，才需额外部署或配置服务端：
- 想实时加载未提交到本地的 API 文档（例如开发中由 Springdoc 或 Swagger UI 自动生成的
/v3/api-docs）→ 需确保目标服务已启动且允许跨域（CORS），或通过本地代理绕过限制 - 文档文件路径是相对 URL（如
./openapi.json），但插件默认只支持绝对路径或本地文件协议 → 需用live-server或http-server启一个静态服务，让插件通过http://127.0.0.1:5500/openapi.json加载 - 使用
Swagger Editor类插件在线编辑并“Try it out”，这时它会尝试向你填的host/servers地址发请求 → 服务端必须真实运行、监听对应端口、接受该 Origin 的请求
live-server 是最轻量的临时服务端方案
如果你只是想快速预览本地 openapi.yaml 并支持相对引用或热刷新，live-server 比自己写 Express 路由更直接：
- 全局安装：
npm install -g live-server - 进入文档所在目录，执行：
live-server --port=8080 --no-browser - 在 VSCode 插件里填写 URL：
http://127.0.0.1:8080/openapi.yaml - 注意：插件不会自动 reload 文档内容，需手动刷新 WebView；修改 YAML 后保存，
live-server会触发页面重载（前提是插件支持自动 fetch）
容易被忽略的跨域与路径陷阱
即使服务端跑起来了，插件仍可能报错 Failed to fetch 或空白页，常见原因：
- 服务端没开 CORS：Spring Boot 加
@CrossOrigin，Express 加cors()中间件，或用 Nginx 反向代理加add_header 'Access-Control-Allow-Origin' '*' - 路径写错：插件里填的是
./docs/swagger.json，但live-server根目录不是项目根，导致 404 → 改用绝对路径或调整--root参数 - HTTPS 混合内容：本地用
http://加载文档，但文档里定义的servers是https://，浏览器直接拦截 “Try it out” 请求 - YAML 解析失败：某些插件（如旧版
Swagger Viewer）不支持 YAML 1.2 特性（如!!int标签），换成 JSON 或升级插件
真正卡住的往往不是“怎么配”，而是没意识到：插件本身不解决网络可达性问题，它只负责把能拿到的数据画出来。
