Ctrl+Q显示的是TypeScript Server或JSDoc提供的原始英文API文档，包括类型定义、签名和注释，不经过UI汉化层，因此中文界面下仍为英文，属设计使然。
WebStorm 里 Vue 项目无法直接内联显示中文 API 文档，这是设计使然，不是配置错误。 Ctrl+Q 弹出的文档来自 TypeScript Server 或 JSDoc 注释，它只认原始英文符号和类型定义，不会被 UI 汉化影响。想快速查 Vue 官方 API？得靠外部跳转或插件辅助，而不是指望内联文档自动翻译。
Ctrl+Q 显示的是什么内容？
它展示的是语言服务（TypeScript Server / Volar / Vue Language Features）注入的类型定义和 JSDoc 注释，比如 ref 的返回类型、computed 的泛型约束、onMounted 的参数签名等。这些内容：
- 全部基于项目中安装的
@vue/runtime-core和@vue/reactivity的类型声明文件（.d.ts） - 不经过 WebStorm 翻译层，所以即使界面是中文，
setup()里的props提示仍是 “The props passed to the component” - Vue 3 的组合式 API（如
useSlots、defineProps）依赖 Volar 插件提供语义支持，没装 Volar 就可能只显示 any 类型
为什么 Shift+F1 跳转 MDN 或 Vue 官网经常 404？
WebStorm 默认用符号名拼接 URL，但 Vue 的 API 页面结构和命名规则和原生 JS 不同，导致路径错位。常见失效场景：
-
ref→ 跳转到https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/ref（不存在） -
defineProps→ 被当成普通函数跳转，而非 Vue 特殊宏（macro），URL 构造失败 - 组件名如
RouterLink→ 默认跳转到 MDN，实际应导向https://router.vuejs.org/api/#routerlink
解决办法：手动配置 External Documentation URL 模板，例如对 Vue 符号设置：
立即学习“前端免费学习笔记（深入）”；
https://vuejs.org/api/#%s
注意：%s 是占位符，WebStorm 会把光标下的符号名填进去；defineProps 就会变成 https://vuejs.org/api/#defineprops —— 这个链接才有效。
如何让 Ctrl+Q 内容更贴近 Vue 3 实际用法？
关键在启用 Volar 并关闭旧版 Vue.js 插件：
- 确保已安装
Volar（非 Vue.js 插件），它是 Vue 3 的官方语言支持，提供defineProps、defineEmits的类型推导 - 禁用 Settings → Plugins 中的旧
Vue.js插件（它专为 Vue 2 设计，与 Volar 冲突） - 检查 tsconfig.json 是否启用
"types": ["vue"]，否则ref可能被识别为全局变量而非响应式 API - 如果
computed提示里出现Ref<T>而不是你期望的ComputedRef<T>，说明类型库未正确加载，可尝试重启 TS Server（Ctrl+Shift+P → “Restart TS Server”）
真正实用的 API 查阅组合方案
别只靠 Ctrl+Q，三招配合用才高效：
- 光标停在
watch上，按Shift+F1→ 自动打开https://vuejs.org/api/reactivity-core/#watch（前提是 External Documentation 配置正确） - 选中
onBeforeUnmount，按你设的OnlineSearch2快捷键（如 Shift+A），输入数字 2 → 直跳https://cn.vuejs.org/v2/api/#%s（注意：Vue 3 文档需换为https://vuejs.org/api/域名） - 右键 Ctrl+Q 弹窗 →
Translate to Chinese（仅翻译解释性文字，watch(source, callback, options)这类签名保留英文）
最易被忽略的一点：Volar 的类型提示依赖 tsconfig.json 中 "compilerOptions": { "lib": ["ES2020", "DOM"], "types": ["vue"] } 的完整配置，漏掉 "types" 就会导致所有组合式 API 提示退化为 any。
