WebStorm 不支持为 Vue 项目自定义 Ctrl+Q 文档内容，仅能读取 JSDoc、TS 类型、Volar 语义信息或官方文档链接；常见空白原因包括未安装 Volar 插件、node_modules 未加载、文件类型识别错误或 tsconfig.json 未被识别。
WebStorm 本身不支持为 Vue 项目“自定义快捷文档”内容（比如替换 Ctrl+Q 弹出的文档为自己的说明），它只支持读取已有的 JSDoc、TypeScript 类型定义、Volar 插件提供的语义信息，或 Vue 官方文档链接（需联网且配置正确）。你无法像 Live Templates 那样自由编辑弹窗里的文字。
为什么 Ctrl+Q 在 Vue 文件里没反应或显示空白
常见原因不是配置错了，而是缺少支撑环境：
- 没安装或启用
Volar插件（Vue 3 推荐）或Vue.js插件（Vue 2 兼容）——这是提供类型推导和文档提示的基础 -
node_modules未正确加载，或package.json中没声明vue依赖（WebStorm 会据此启用 Vue 支持） - 文件后缀不是
.vue，或被错误识别为 Plain Text（右下角状态栏检查文件类型是否为Vue.js） - 项目没启用 TypeScript，而你在
<script setup lang="ts">里写了类型，但 WebStorm 没识别到tsconfig.json
让 Quick Documentation 显示 Vue 相关内容的实际条件
只有满足以下组合，Ctrl+Q 才可能在 <script> 或 <template> 中给出有用信息：
- 使用
Volar（非 Vue.js 插件），且已设为 默认 Vue 插件（Settings → Languages & Frameworks → JavaScript → Libraries → Vue.js → Use Volar as default -
shims-vue.d.ts存在并正确声明了defineComponent和defineAsyncComponent等全局类型 - 在
<script setup>中用了defineProps/defineEmits，且参数是运行时声明（如defineProps({ msg: String })）或类型导入（defineProps<props>()</props>） - 鼠标悬停在组件名、指令（如
v-if）、或 Composition API 函数（如ref、computed）上——这些才可能触发文档
注意：<template> 中的自定义组件名能否显示文档，取决于该组件是否被正确 import 并注册（全局/局部），否则只会显示 “Unknown component”。
立即学习“前端免费学习笔记（深入）”；
能“间接影响”Quick Documentation 显示效果的操作
虽然不能写死一段文档进去，但你可以通过以下方式提升实际可用性：
- 在
<script setup>上方加 JSDoc 注释，例如：/** * @description 用户资料卡片组件 * @example <user-card :user="currentUser" /> */
—— 这段会出现在组件名的Ctrl+Q弹窗顶部 - 为
defineProps的每个字段写 JSDoc：defineProps({ /** 用户头像 URL，必填 */ avatar: { type: String, required: true }, /** 是否显示编辑按钮 */ editable: Boolean })—— 悬停在avatar上时，会显示这行注释 - 确保
Settings → Editor → General → Show quick documentation on mouse move已勾选，并调高Tooltip delay（避免误触） - 禁用冲突插件：某些旧版
Vue.js插件与Volar共存时会导致文档功能失效，必须二选一
真正卡住的地方往往不是“怎么加文档”，而是 Volar 没接管、类型没解析、或者组件没被识别为可导入模块——这些底层信号断了，再漂亮的注释也出不来。
