Hover功能可快速查看代码文档,将鼠标悬停在变量、函数等上即可显示类型信息和注释,支持Python、TypeScript等语言,需安装对应扩展,可通过Ctrl+K Ctrl+I手动触发,设置中可调整自动显示与延迟时间。

在 VSCode 中使用悬浮提示(Hover)查看文档非常简单,只需将鼠标指针悬停在代码中的变量、函数、类或方法上,VSCode 就会自动显示相关的类型信息和文档说明。
启用 Hover 提示功能
VSCode 默认已开启 Hover 功能,无需额外配置。只要你的项目支持语言服务(如 TypeScript、Python、Java 等),就能看到提示。
确保安装了对应语言的扩展,例如:
- Python:安装 "Python" 扩展(由微软提供)
- TypeScript/JavaScript:内置支持
- 其他语言查看官方扩展市场
查看文档内容
当鼠标悬停在某个符号上时,悬浮框会显示以下信息:
- 类型签名:函数参数、返回值类型
- JSDoc 或 docstring:开发者写的注释文档
- 定义来源:来自哪个文件或模块
例如,在 Python 中写有三引号字符串的函数,悬停时会完整显示说明。
快捷键触发 Hover
除了鼠标悬停,还可以用键盘操作:
- Windows/Linux:按 Ctrl + 鼠标悬停 可增强提示(部分语言适用)
- macOS:按 Cmd + 鼠标悬停
- 统一快捷键:Ctrl + K Ctrl + I**(保持 Ctrl 按下,依次按 K 和 I)可在光标位置手动触发 Hover
自定义 Hover 行为
可通过设置调整 Hover 的显示方式:
- 打开设置(Ctrl + ,)
- 搜索 "hover" 相关选项
- 可控制是否自动显示、延迟时间、是否在提示中包含文档等
比如关闭自动弹出,改为仅通过快捷键调用,减少干扰。
基本上就这些。Hover 是快速理解代码的好工具,配合良好的注释习惯效果更佳。










