VSCode悬浮提示默认不换行,因tooltip渲染层独立于编辑器,editor.wordWrap对其无效;需注入CSS强制折行(修改styles.css并完全重启),或更可靠地使用Ctrl+K Ctrl+I呼出支持自动换行的Hover面板。

VSCode悬浮提示(IntelliSense)默认不换行,改设置没用
VSCode 的函数签名、参数说明、JSDoc 提示弹窗(即 IntelliSense tooltip)压根不响应 editor.wordWrap。这不是你配错了,是它根本没这个开关——monaco-editor 的 tooltip 渲染层完全独立于编辑器主文本区域,所有 word-wrap 类设置对其无效。
常见错误现象包括:长 JSDoc 描述被截成一行加省略号(…)、TypeScript 联合类型显示不全、参数列表挤在单行看不清。这时候去 settings.json 里反复调 editor.wordWrap 或 editor.wordWrapColumn,只会白忙活。
强制换行只能靠 CSS 注入,且必须重启生效
唯一能干预 tooltip 文字折行的方式,是向 VS Code 桌面版注入自定义 CSS。注意:Web 版(vscode.dev)不支持;热重载无效,改完必须完全退出再启动。
- 找到用户 styles.css 路径:
~/.vscode/Code/User/styles.css(macOS/Linux)或%USERPROFILE%\AppData\Roaming\Code\User\styles.css(Windows) - 创建该文件(若不存在),写入以下内容:
.monaco-editor .suggest-widget .monaco-list-row .monaco-highlighted-label,
.monaco-editor .parameter-hints-widget .parameter-hints,
.monaco-editor .hover-content {
white-space: pre-wrap !important;
word-break: break-word !important;
}
效果因语言服务器而异:TypeScript 官方插件通常响应良好;部分 Python LSP(如 Pylance 旧版)或自定义语言扩展可能忽略该样式,无法保证 100% 生效。
更可靠的做法:别依赖悬浮弹窗,用 Ctrl+K Ctrl+I 呼出 Hover 面板
与其折腾不稳定且需重启的 CSS,不如直接使用 VS Code 内置的 Hover 面板——它天然支持滚动和自动换行,渲染逻辑与编辑器主区域一致,editor.wordWrap 对它有效。
- 光标停在函数/变量上,按
Ctrl+K Ctrl+I(Windows/Linux)或Cmd+K Cmd+I(macOS) - Hover 面板会以侧边栏或浮动窗口形式展开,完整显示 JSDoc、类型定义、源码引用等
- 如果当前文件已启用
editor.wordWrap: "on",面板内长文本会自然折行,无需额外配置
对 TypeScript / JS 项目,这比悬停弹窗更稳定;对 Python,Pylance 的 Hover 同样支持完整文档渲染,且不会受 CSS 注入兼容性问题影响。
折叠功能和悬浮提示是两套系统,别混在一起设
有人试图通过调整 editor.foldingStrategy 或 editor.showFoldingControls 来改善提示弹窗,这是方向错误。代码折叠控制的是编辑器左侧的 ▶ 图标和快捷键行为(如 Ctrl+Shift+[),和 tooltip 渲染毫无关系。
真正容易被忽略的一点是:Hover 面板(Ctrl+K Ctrl+I)和跳转定义(F12)才是查看长文档的正解。弹窗只是轻量预览,设计定位就是“一眼扫过”,不是“逐字阅读”。把期望值放在这两个快捷键上,比调样式靠谱得多。











