sticky scroll需语言、结构、光标三重条件才生效；默认仅显示1–2层，调maxlayerdepth至3或4可支持深层嵌套；其内容完全依赖语言服务器，lsp异常会导致显示异常。
Sticky Scroll 不是“开了就显示”，它只在满足语言、结构、光标三重条件时才生效；开不开对编码没影响，但读长函数或嵌套逻辑时，能少翻十几次滚轮。
为什么开了 editor.stickyScroll.enabled 却什么也不显示
这不是配置错了，而是环境没达标。常见失效链路如下：
- 右下角语言模式不是
Python、TypeScript、C#、Rust等支持大纲（Outline）的语言——Plain Text或未识别的.log文件必然不工作 - 代码里没有被语言服务器认可的“可折叠结构”：比如
def后面没缩进块、if后没冒号+换行缩进、class下全是空行或注释 - 光标没落在嵌套块内部，或者还没向下滚动到让起始行移出可视区——停在
def foo():那一行不动，它就不会“粘” - 验证方法很简单：按
Ctrl+Shift+O打开大纲视图，如果这里也为空或层级错乱，问题一定出在语言服务（比如typescript-language-server没启动，或 Python 扩展崩溃），不是 Sticky Scroll 本身
怎么调出多层嵌套上下文（比如 class → method → then()）
默认只显示 1–2 层，对 TS/JS 链式调用或 Python 深层回调远远不够。关键不是改 maxLineCount，而是调 maxLayerDepth：
-
editor.stickyScroll.maxLayerDepth控制解析深度，默认是2；设为3或4才能捕获内联函数、.then()、async with等深层作用域 -
editor.stickyScroll.maxLineCount只控制顶部最多显示几行（默认5），设太高会遮挡代码，且超出实际嵌套深度只是留空行 - TS/JS 用户注意：如果
then()或箭头函数没显示，大概率是maxLayerDepth太低，不是语法写错了 - Python 用户注意：
def和class稳定，但裸if块或for循环的识别依赖缩进和语言服务精度，不保证每层都出现
如何临时开关或按语言禁用
不需要改配置文件就能快速验证效果：
- 快捷键：
Cmd+K S（macOS）或Ctrl+K S（Windows/Linux），状态栏右下角实时显示Sticky Scroll: On/Off - 命令面板输入
Toggle Sticky Scroll，适合单个文件临时调试 - 想禁用特定语言（比如 Markdown 或 JSON）：打开命令面板 →
Preferences: Configure Language Specific Settings→ 选markdown→ 加一行"editor.stickyScroll.enabled": false - 别在
settings.json里给所有语言统一关掉——它对.py和.ts是真有用，关掉反而增加认知负担
最常被忽略的一点：Sticky Scroll 显示的内容完全来自语言服务器的 DocumentSymbolProvider，不是编辑器自己猜的。所以当你发现顶部只显示 function 没名字，或者层级突然断掉，优先检查 LSP 是否正常运行，而不是反复调 maxLineCount。
