Sticky Scroll是VSCode 1.84+内置的动态上下文导航功能，仅在满足语言支持、语法结构和光标位置三前提下，将当前嵌套作用域起始行“粘”于编辑器顶部左侧。
Sticky Scroll 不是“悬浮提示”，也不是靠鼠标悬停触发的；它只在你向下滚动时，把当前嵌套结构（如 class、def、if）的起始行“粘”在编辑器顶部左侧——而且必须满足语言、结构、光标位置三个硬性条件，否则开了也白开。
为什么开了设置但顶部什么也不显示？
最常见原因是没满足 Sticky Scroll 的运行前提，不是配置错了，而是环境没到位：
- 右下角语言模式必须是
Python、TypeScript、Java、C#等支持大纲（Outline）的语言，不能是Plain Text或未配好解析器的Markdown - 文件里得有真实可折叠的语法结构：比如
class后跟缩进块、def后有函数体、if后有冒号和下一行缩进——空行、注释开头、没缩进的代码行都会让语言服务识别失败 - 光标必须落在某个嵌套块内部（比如
return a + b那行），且你已经向下滚动，让该块的起始行（比如def add(self, a, b):）移出可视区——没滚动，它就不“粘”
验证方式：按 Ctrl+Shift+O 打开大纲视图，如果这里也为空或层级错乱，说明问题出在语言服务本身，不是 Sticky Scroll 设置的问题。
怎么正确启用并调出多层上下文？
默认开启后只显示 1–2 层，对长函数或深度回调不够用。关键参数有两个，别混淆：
-
editor.stickyScroll.enabled：全局开关，设为true才启动功能（默认false） -
editor.stickyScroll.maxLineCount：控制顶部最多显示几行标题（默认5），值越大越“全”，但别设太高，超过实际嵌套深度只是留空行 -
editor.stickyScroll.maxLayerDepth：控制解析深度（默认2），影响能否识别到内联函数、then()回调等深层作用域，设为3或4更适合 TS/JS 链式调用
推荐配置（加到 settings.json）：
"editor.stickyScroll.enabled": true, "editor.stickyScroll.maxLineCount": 4, "editor.stickyScroll.maxLayerDepth": 3
哪些情况会让 Sticky Scroll 显示异常或消失？
不是 bug，是语言服务被干扰后的必然表现：
- 函数开头有多行 JSDoc 注释但格式不标准（比如首行空、缺少
/**），DocumentSymbolProvider解析失败，导致只显示function没名字 - 手动折叠了代码块（
Ctrl+Shift+[），Sticky Scroll 不会主动展开，也就读不到里面的内容 - 用了
<script setup>这类隐式导出语法，部分 TS 插件无法稳定提供符号层级 - 装了 Bracket Pair Colorizer、Indent-Rainbow 这类覆盖渲染层的扩展，可能遮挡或错位粘性条
临时排查：禁用所有非必要扩展，新建 test.ts 写一个带 class → method → Promise.then() 的三层结构，再试。
快捷键和语言级关闭技巧
不用反复进设置改来改去：
- 临时开关：焦点在编辑器时按
Ctrl+K S（Windows/Linux）或Cmd+K S（macOS），状态栏右下角实时显示状态 - 对 Markdown 关闭：用
Cmd+Shift+P→Preferences: Configure Language Specific Settings→ 选markdown→ 加"editor.stickyScroll.enabled": false - 别碰
editor.stickyScroll.defaultEnabled：这个配置项不存在，VS Code 不认，写了也无效
真正容易被忽略的是：Sticky Scroll 的“粘”不是靠 CSS fixed 实现的，它依赖语言服务器持续提供准确的 DocumentSymbol 树。一旦符号解析中断（比如 LSP 崩溃、项目没 tsconfig.json），顶部立刻变空——这时候修配置没用，得先让大纲视图能正常工作。
