vscode 本身不会自动更新 typescript 类型声明——它不监听接口变更、不重生成 .d.ts、也不感知后端 json schema 或 openapi 变动；所谓“自动更新”依赖插件（如 volar）、手动触发（如重启语言服务器）和正确配置（如 tsconfig.json include 设置）三者协同。
VSCode 本身不会自动更新 TypeScript 类型声明——它不监听接口变更、不重生成 .d.ts、也不感知后端 JSON Schema 或 OpenAPI 变动。所谓“自动更新”，实际是靠插件 + 手动触发 + 正确配置三者协同完成的。
为什么改了 API 返回结构，VSCode 还提示旧类型？
因为 TypeScript 语言服务（volar / typescript-language-features）只在以下时机重新推导类型：
- 保存
.vue或.ts文件（但仅限当前文件上下文） - 手动执行
Developer: Restart Language Server（强制全量重解析） - 重载窗口（
Developer: Reload Window），等价于重启 volar - 修改
tsconfig.json并保存（触发 tsconfig 重载）
如果你改了后端返回的 JSON 示例，或更新了 openapi.json，但没触发上述任一动作，VSCode 就永远用着旧缓存的类型。这不是 bug，是设计使然：TS 不会主动轮询外部数据源。
JSON to TS 插件能“自动生成”，但不能“自动同步”
JSON to TS 这类插件本质是「一次性转换器」：粘贴 JSON → 按快捷键 → 输出 interface。它不监听文件变化，也不写入项目目录，更不关联 API 调用逻辑。
- 快捷键默认是
Ctrl+Shift+Alt+S（Windows/Linux），macOS 是Cmd+Shift+Option+S - 生成结果默认弹出新编辑器标签，需手动复制粘贴到
types/index.ts或对应位置 - 如果 JSON 含
null值，插件可能生成string | null，但不会自动加strictNullChecks: true校验 - 嵌套过深（如 5 层以上对象数组）时，部分插件会退化为
any或省略字段，需人工补全
volar 对 Vue 的 defineProps 类型更新最敏感
在 <script setup lang="ts"></script> 中改了 defineProps 类型，但没生效？大概率是 volar 没刷新上下文。
- 确认
.vscode/settings.json里已禁用 vetur："vetur.validation.template": false - 检查
tsconfig.json的"include"是否包含"**/*.vue" - 运行命令面板 → 输入
Developer: Restart Language Server，不要只点保存 - 若仍无效，删掉项目根目录下可能存在的
.volarignore（它会跳过某些文件夹）
真正接近“自动”的方案：脚本 + watch + 插件 API
想让类型声明随 OpenAPI 变动实时更新，得跳出 VSCode 插件思维，走 CLI 流程：
- 用
openapi-typescriptCLI 工具监听openapi.json变化，自动生成types/api.ts - 在
package.json的"scripts"中加"watch:types": "openapi-typescript ./src/api/openapi.json -o ./src/types/api.ts --watch" - 启动
npm run watch:types后，只要 JSON 更新，TS 文件就自动重写 - VSCode 会立刻感知该文件变化，并将新类型注入语言服务（无需重启）
这个链路里，VSCode 只负责读取已生成的 TS 文件，不参与生成逻辑——这才是稳定、可复现、可 CI 集成的做法。插件适合临时尝鲜，脚本才是生产环境的底线。
