粘性滚动需同时满足语言模式正确、存在可折叠结构、光标位于嵌套块内且已滚过起始行四个条件才生效；依赖语言服务器提供大纲信息，非静态语法高亮。
粘性滚动（Sticky Scroll）不是“开了就显示”，它只在满足结构、语言、光标和滚动状态四个条件时才生效——尤其对长函数这类深度嵌套场景，必须让光标落在函数体内且已滚过函数定义行，顶部才会出现实时置顶的导航栏。
为什么开了 editor.stickyScroll.enabled 却看不到导航栏
常见错误现象是设置已开启，但编辑器顶部始终空白。这不是配置失败，而是触发条件未满足：
- 当前文件语言模式必须正确（右下角显示
Python、Java、TypeScript等，不能是Plain Text或未识别的Unknown） - 文件中需存在语言服务器能解析的可折叠结构（如
def、class、public void、if块首行），纯文本或注释块不触发 - 光标必须位于某嵌套块内部（例如长函数体中某一行），且视图已向下滚动、使该块起始行移出可视区域
- 若使用了 Bracket Pair Colorizer、Indent Rainbow 等渲染类扩展，可能遮挡粘性条，建议临时禁用排查
editor.stickyScroll.maxLineCount 设多少才适合长函数
默认值 5 对多数场景够用，但长函数常嵌套多层（函数→if→for→try→lambda），这时需要调高才能看到完整上下文：
- 设为
3～4：适合浅层结构，避免信息过载 - 设为
6～8：适合含多重条件/循环/异常处理的长函数，能同时看到函数名 + 当前 if 分支 + 内层 for 起始行 - 注意：该值只控制“显示行数”，不影响解析深度；即使设为
10，若语言服务没提供 10 层结构数据，也只会显示实际识别到的层级
如何快速验证粘性滚动是否真在工作
别依赖已有大文件测试——容易因结构不规范或扩展干扰误判。用最小可验证案例：
- 新建
test.py，写一个三层嵌套的函数：
class DataHandler:
def process(self, items):
for item in items:
if item.get("valid"):
try:
return item["value"] * 2
except KeyError:
return 0
- 把光标放在
return item["value"] * 2这一行 - 向下滚动，直到
def process(self, items):这行完全消失在顶部视野外 - 此时顶部应出现带背景色的粘性条，从上到下依次显示：
class DataHandler→def process(self, items)→for item in items:→if item.get("valid"):
真正容易被忽略的是：粘性滚动依赖语言服务实时提供大纲（Outline）信息，而不是静态语法高亮。如果某个语言扩展没启用语言服务器（比如只装了 Python 语法包但没装 Pylance），即使文件后缀正确，editor.stickyScroll.enabled 也会静默失效。
