根本原因是WebStorm未将props类型定义视为“真类型”解析，尤其对PropType、联合类型或泛型（如PropType<Enum>、Array<string>）默认不展开推导；需在tsconfig.json中配置"moduleResolution": "bundler"、"strictNullChecks": false、"types": ["vue"]三项。
WebStorm 为什么看不到 props 类型校验提示？
根本原因不是 Vue 配置错，而是 WebStorm 没把 props 的类型定义当“真类型”解析——尤其在使用 PropType、联合类型或泛型时，它默认只认最基础的 String、Number 这类构造函数字面量。TDesign Vue Next 等库大量用 PropType<Enum> 或 Array<string> 写法，WebStorm 默认不展开泛型推导，直接跳过校验提示。
tsconfig.json 必须改的三项配置
仅装 Vue 插件或开 inspections 不够，关键在 TypeScript 编译器行为控制：
-
"moduleResolution": "bundler"—— 否则 WebStorm 会按传统 Node resolution 查node_modules，错过组件库内置的.d.ts声明文件 -
"strictNullChecks": false—— TDesign Vue Next 当前版本（≤1.11.0）的类型定义未完全适配严格空值检查，开启后反而让type: String | null这类写法被标红但实际运行无误 -
"types": ["vue"]—— 显式引入 Vue 官方类型声明，否则PropType、defineProps等 API 无法被识别为有效类型工具
Vue 指令和自定义 prop 提示要手动加白名单
WebStorm 默认把 v-if、@click 当成未知 HTML 属性，导致模板里没补全、也没类型提示：
Ainative Vue Sdk
下载
使用 `@ainative/vue-sdk` 为 Vue 3 应用添加 AI 聊天功能。适用于以下场景：(1) 安装 `@ainative/vue-sdk`，(2) 在 Vue 组件中使用 `useChat` 组合式函数，(3) 提供……
- 进
Settings → Editor → Inspections → HTML → Unknown HTML tag attribute - 勾选该检查项，并在下方输入框粘贴：
v-if v-else v-for v-show v-bind v-on v-model v-text v-html @click @change :class :style - 重启索引（
File → Reload project from disk），否则新增的指令不会立刻生效
复杂 props 校验函数不提示？换 validator 写法
WebStorm 对 validator 函数内部逻辑几乎不分析，但能识别其返回值是否参与类型约束。如果想让 IDE 知道某个 prop 只接受特定枚举值，别只靠函数校验：
立即学习“前端免费学习笔记（深入）”；
- 用
type明确限定可选范围：例如type: String as PropType<'left' | 'right' | 'top' | 'bottom'> - 避免在
validator里用Object.prototype.toString.call(value)这类运行时判断——WebStorm 解析不到，但浏览器能跑 - 若必须用自定义逻辑，把校验条件提前声明为类型别名：
type Position = 'left' | 'right';，再在type中引用
真正卡住的点往往不在代码写法，而在 WebStorm 没把 tsconfig.json 当作项目根配置读取——确认右下角 TypeScript 面板显示的配置路径确实是项目根目录下的那个文件，而不是从 node_modules 里 fallback 的默认配置。
