VSCode 中启用 sticky scroll 可解决大文件滚动时丢失上下文的问题：需开启 editor.stickyScroll.enabled，设置 editor.stickyScroll.maxLayerDepth 为 3–4，并可通过 settings.json 手动配置或按语言禁用。
如果您在使用 VSCode 编辑大型源文件时，因快速滚动而丢失当前代码块的上下文（例如函数名、类名或作用域边界），则可能是由于编辑器未启用或未正确配置 sticky scroll 功能。以下是启用并优化该功能的操作步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、启用 sticky scroll 功能
sticky scroll 依赖于 VSCode 的内置设置控制，需手动开启以激活顶部固定上下文行。该功能默认可能处于关闭状态，启用后可使当前代码块的顶层声明（如函数、类、接口）在滚动时固定显示在编辑器顶部区域。
1、按下 Cmd + , 打开设置界面。
2、在搜索框中输入 editor.stickyScroll.enabled。
3、勾选对应选项，或点击右侧开关将其设为 true。
二、调整 sticky scroll 显示层级数量
VSCode 允许自定义 sticky scroll 固定显示的嵌套层级深度，默认为 2 层（如类 + 方法），增加层数可提升复杂嵌套结构中的上下文可见性。
1、在设置搜索框中输入 editor.stickyScroll.maxLayerDepth。
2、将数值修改为 3 或 4（最大支持 5）。
将PDF文件（含扫描件、图片）转换为Markdown格式。接入MinerU和PaddleOCR双引擎，支持扫描件OCR识别、公式表格解析、多语言识别。兼容本地OCR识别。
3、确认更改后，重新滚动查看效果。
三、通过 settings.json 手动配置
当图形化设置界面无法生效或需批量部署时，可直接编辑用户设置文件，确保 sticky scroll 参数被明确写入且不受工作区覆盖影响。
1、按下 Cmd + Shift + P 打开命令面板。
2、输入并选择 Preferences: Open Settings (JSON)。
3、在花括号内添加如下行（注意末尾逗号格式）：
"editor.stickyScroll.enabled": true,
"editor.stickyScroll.maxLayerDepth": 3
四、禁用特定语言的 sticky scroll
部分语言（如 Markdown 或纯文本）无需上下文固定，可通过 language-specific 设置关闭，避免干扰阅读体验。
1、打开设置界面，点击右上角 {} 图标 进入 JSON 模式。
2、在 "[markdown]" 配置块内添加：
"editor.stickyScroll.enabled": false
3、保存文件后，在 Markdown 文件中滚动验证是否已失效。
