Sticky Scroll是VSCode 1.84+内置功能,非插件,需手动启用editor.stickyScroll.enabled: true;仅在支持大纲的语言、存在可折叠结构、光标位于嵌套块内且已滚动过起始行时生效,依赖语言服务器提供符号信息。

VSCode 的 stickyScroll(粘性滚动条)不是独立插件,而是 1.84 版本起内置的编辑器功能,它让滚动时顶部的嵌套结构(如函数、类、if 块)保持可见。但默认开启后常出现「标题遮挡」「层级错乱」「缩进不齐」等问题——这不是 bug,是它和主题配色、字体渲染、缩进设置共同作用的结果。
为什么 sticky scroll 总是显示不全或错位?
根本原因是 VSCode 没有为 sticky scroll 单独提供一套颜色变量,它复用的是编辑器边框与背景色,而很多主题(尤其是深色系)未覆盖 editorStickyScroll.background 和 editorStickyScroll.border 这两个关键项。
- 常见错误现象:
sticky scroll文字发灰看不清、右侧被截断、悬停时背景色和编辑器融为一体 - 触发条件:启用
"editor.stickyScroll.enabled": true后,再换用非官方主题(如Github Theme、Nord、One Dark Pro) - 必须手动在
settings.json中补全以下两项,否则它会退回到系统默认灰底白字,且无法响应主题切换
{
"workbench.colorCustomizations": {
"editorStickyScroll.background": "#1e1e1e",
"editorStickyScroll.border": "#3c3c3c"
}
}
如何让 sticky scroll 层级缩进对齐代码实际结构?
它默认只显示 3 层(editor.stickyScroll.maxLineCount),且缩进单位固定为 2 字符(editor.stickyScroll.indentation),但 Python 或 YAML 等语言常用 4 字符缩进,就会导致视觉错位。
- 修改
editor.stickyScroll.maxLineCount可设为 5,避免深层嵌套被截断 -
editor.stickyScroll.indentation必须和你当前文件的editor.tabSize一致,否则缩进看起来“漂”在代码左边 - 注意:该缩进值不会自动随文件类型变化,若项目混用 2/4 缩进(如 JS + Python),建议统一为 4,或在
.vscode/settings.json中按语言覆盖
"[python]": {
"editor.tabSize": 4,
"editor.stickyScroll.indentation": 4
}
sticky scroll 和 minimap / scrollbar 冲突怎么办?
三者共存时,右侧空间会被挤压,尤其在窄屏或高 DPI 下,sticky scroll 容易被 minimap 遮住半边,或和原生 scrollbar 重叠。
- 优先关闭
minimap:"editor.minimap.enabled": false,它对大多数现代项目已非必需 - 若需保留 minimap,可调小其宽度:
"editor.minimap.size": "fit"或"small" - 原生
scrollbar不影响 sticky scroll 渲染,但若用了自定义滚动条插件(如Customize UI),务必确认它未覆盖.monaco-editor .sticky-scroll的 CSS 定位
真正难调的不是参数本身,而是它没有独立的字体大小控制 —— sticky scroll 文字永远跟随编辑器 fontSize,哪怕你把 editor.fontSize 设为 14,它也会显得比代码行更挤。如果发现文字糊成一团,别急着改颜色,先检查是否启用了字体抗锯齿或 ClearType 设置冲突。这个点绝大多数人会忽略,直到换显示器才发现问题突然消失。











