Sticky Scroll默认关闭，需手动启用editor.stickyScroll.enabled: true；仅在语言模式正确、存在可折叠结构、光标位于嵌套块内且已滚动过起始行时生效，依赖语言服务器提供大纲信息。
editor.stickyScroll.enabled 默认是 false，不开启就看不到任何粘性条——这不是 bug，是设计如此。它只在满足语言、结构、光标和滚动四重条件时才出现，开不开对写代码没影响，但读长函数或嵌套逻辑时能少翻滚轮。
怎么快速打开 Sticky Scroll 开关
别找插件、别装扩展，VSCode 1.84+ 原生支持，改一个布尔值就行：
- 快捷键
Ctrl+,（Windows/Linux）或Cmd+,（macOS）打开设置 - 右上角搜
sticky scroll，勾选Editor > Sticky Scroll: Enabled - 或者直接编辑
settings.json，加一行："editor.stickyScroll.enabled": true - 改完不用重启，但已打开的文件需手动重载（
Ctrl+R或右键标签页 → Reload Window）才能生效
为什么开了却什么也不显示
常见现象是设置已开，顶部依然空白。问题几乎从不在配置本身，而在触发条件未满足：
- 右下角语言模式必须是
Python、TypeScript、Java、C#等支持大纲（Outline）的语言，Plain Text或未识别的.log文件必然失效 - 代码里得有真实可折叠结构：比如
def后必须跟缩进块，if后必须有冒号+换行缩进，空行或注释开头会中断识别 - 光标必须落在某嵌套块内部（如
return x那行），且你已向下滚动，让该块起始行（如def func():）完全移出可视区 - 验证方法：按
Ctrl+Shift+O打开大纲视图，如果这里也为空或层级错乱，说明语言服务器（如typescript-language-server）没跑起来，不是 Sticky Scroll 的问题
maxLineCount 和 maxLayerDepth 怎么设才不踩坑
这两个参数常被混淆，但作用完全不同：
-
editor.stickyScroll.maxLineCount控制顶部最多显示几行标题，默认5；设太高（如10）会遮挡代码，设太低（如1）只剩最外层 class，失去导航意义；多数场景推荐3或4 -
editor.stickyScroll.maxLayerDepth控制解析深度，默认2；TS/JS 的.then()、箭头函数、async with这类深层作用域需要设为3或4才能捕获，否则只显示到函数层就断了 - 示例配置（加到
settings.json）："editor.stickyScroll.enabled": true,<br>"editor.stickyScroll.maxLineCount": 4,<br>"editor.stickyScroll.maxLayerDepth": 3
哪些情况会让粘性条异常或消失
不是 bug，而是语言服务能力边界或干扰导致的必然表现：
-
Markdown、JSON、Plain Text文件默认不提供可靠大纲信息，强行开启只会留空行；应在语言专属设置中禁用："[markdown]": { "editor.stickyScroll.enabled": false } - 函数开头有多行非标准 JSDoc（首行空、缺
/**），DocumentSymbolProvider解析失败，导致只显示function没名字 - 手动折叠了代码块（
Ctrl+Shift+[），Sticky Scroll 不会主动展开，也就读不到里面的内容 - 装了
Bracket Pair Colorizer、Indent-Rainbow这类覆盖渲染层的扩展，可能错位或遮挡粘性条，临时禁用可验证
DocumentSymbolProvider，不是编辑器自己猜的。如果某个语言扩展没启用 LSP（比如只装了 Python 语法高亮但没装 Pylance），那再调参数也没用。 
