Sticky Scroll需同时满足三前提才生效：语言模式正确、存在可折叠结构、光标位于已滚动出视图的嵌套块内；开关用命令面板“Toggle Sticky Scroll”最便捷；maxLineCount默认5较平衡，Markdown/JSON等因无大纲支持而失效。
Sticky Scroll 不显示？先确认三个硬性前提
它不是开了设置就自动“粘”起来的——必须同时满足：
• 当前文件语言模式正确（右下角显示 Python、Java、JavaScript，不能是 Plain Text）
• 文件里有被语言服务识别的可折叠结构（比如 class、def、public void、if 块首行）
• 光标位于某嵌套块内部，且视图已滚动过该块的起始行（即你已经往下拉了一段，起始行不在可视区了）
常见错误现象：开了设置但顶部空空如也。这时候别急着改配置，先新建一个 test.py，写几层嵌套：
class Calculator:
def add(self, a, b):
if a > 0:
return a + b
把光标放在 return a + b 那行，再向下滚动——这时顶部才应出现带背景色的粘性条。
怎么快速开关 Sticky Scroll？别去 Settings 翻半天
临时调试或对比阅读时，用命令面板最省事，不用改配置也不重启：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS） - 输入
Toggle Sticky Scroll，回车执行 - 状态栏右下角会立刻显示
Sticky Scroll: On或Sticky Scroll: Off
这个操作只影响当前编辑器窗口，不改动任何 JSON 设置，适合在 Markdown 笔记里关掉它，切回 Python 文件又自动恢复。
maxLineCount 设成多少合适？别盲目调高
editor.stickyScroll.maxLineCount 控制最多显示几层上下文，默认是 5，但不是越大越好：
- 设为
8或10在深度嵌套的 Java 类里可能有用，但容易挤占顶部空间，遮挡部分代码行 - 设为
3更清爽，适合多数 Python/JS 场景（模块 → 类 → 函数 就够定位） - 注意：它只显示“当前光标所在路径上的层级”，不会把整个文件大纲都堆上来
推荐做法：先保持默认 5，真遇到多层 with + for + if 嵌套看不清时，再局部调到 6 或 7。
为什么 Markdown / JSON 文件里 Sticky Scroll 失效？这不是 Bug
Sticky Scroll 依赖语言服务提供的大纲（Outline）信息，而 Markdown、JSON、Plain Text 默认不提供可靠的代码块结构解析——它压根不知道哪是“节”、哪是“子节”。
强行开启只会显示空行或错位标签，反而干扰阅读。正确做法是按语言禁用：
- 打开命令面板，输入
Preferences: Configure Language Specific Settings - 选
markdown，然后在生成的"[markdown]"块里加一行："editor.stickyScroll.enabled": false - 同理可对
jsonc、plaintext单独关闭
真正容易被忽略的是：某些自定义语法扩展（比如老旧的 Vue 或 YAML 插件）可能没实现 Outline Provider，导致 Sticky Scroll 在这些文件中静默失效——这时要查插件文档，而不是怀疑 VS Code。
