VSCode 的同步滚动仅支持同一编辑器组内两个纯代码编辑器的手动联动，唯一有效方式是命令面板执行“Editor: Toggle Synchronized Scrolling”，其他配置、插件或界面开关均无效或受限；跨文件对比应使用内置 Compare 功能。
VSCode 没有全局“多文件同步滚动”开关，也不支持跨窗口、跨编辑器组或预览标签的联动；真正可用的同步滚动，仅限于同一编辑器组内两个纯代码编辑器之间，且必须手动触发命令，不能靠配置项或插件替代。
Editor: Toggle Synchronized Scrolling 是唯一有效入口
这个命令是 VSCode 原生实现同步滚动的唯一通道，所有其他方式（如设置 editor.synchroScroll、安装“Sync Scroll”类插件、勾选右上角 Sync Scrolling）要么已失效，要么只在极少数场景下起作用。
-
editor.synchroScroll字段在 VSCode 1.85+ 中已被彻底移除，写进settings.json会被自动删除，不报错也不生效 - 右上角的 Sync Scrolling 勾选项只出现在「同一文件的多个视图」中（比如用
Split Editor in Group克隆出的副本），不是通用控制开关 - 所谓“同步滚动插件”，基本都面向跨进程/跨实例场景，和本需求无关，还容易与原生机制冲突
- 必须通过命令面板：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入并执行Editor: Toggle Synchronized Scrolling
同步滚动只对当前编辑器组生效，且结构敏感
你看到的左右两个面板，只有满足特定组织关系，才能被识别为“可同步的一组”。一旦结构不对，命令执行成功也无反应。
- 必须由
Ctrl+\、右键 →Split Right或命令View: Split Editor Right创建，而不是拖文件进新窗口、也不是新开 Developer: New Window - 两侧都必须是常驻编辑器：如果某侧是预览标签（单击文件名未双击打开），同步会自动断开；需双击标签使其固定
- 不能混入终端、GitLens 提交视图、大纲、Markdown 预览等非纯文本编辑器面板
- 执行
Ctrl+K Ctrl+←/→切换到其他编辑器组后，同步状态重置，必须重新运行该命令 - 两个文件路径不同（如
src/main.ts和dist/main.js），VSCode 视为独立文件，不阻止同步，但行数差异会导致比例对齐而非逐行对应
对比不同文件时，别手动分屏 —— 用 Compare 功能
手动在左右分屏打开两个不同文件再开同步，容易错位、不可靠，且无法利用差异高亮等关键能力。VSCode 的 Compare Active File With 才是专为此设计的正解。
- 打开基线文件后，按
Ctrl+Shift+P→ 输入并执行File: Compare Active File With→ 选目标文件 - 该对比视图默认开启同步滚动，顶部有显式开关，右上角 ⚙️ 菜单支持
Ignore Whitespace等过滤 - Git 场景下更直接：资源管理器中右键文件 →
Open Changes from [branch] - 注意：对比视图中点击 ← 或 → 应用更改后，VSCode 会自动将光标居中到该行，可能打断你正在看的上下文；若一侧被外部修改（如
git stash pop），内容不会自动刷新，需关闭重开对比窗口
临时跳过同步、快速对齐、避免踩坑的关键操作
同步滚动不是“锁定”，而是“跟随”；它脆弱、易中断，但有办法绕过限制，又不破坏状态。
- 按住
Alt（Windows/Linux）或Option（macOS）再滚动任意一侧，松开即恢复同步 —— 这是隐藏但稳定有效的临时绕过方式 - 不需要全程同步？想快速跳到另一侧相同行号：左侧光标在第 42 行，右侧地址栏输入
42回车即可跳转（要求两文件逻辑行数大致一致） - 大文件（>10MB）同步滚动有轻微延迟，属正常现象，不是配置错误或插件问题
- 同步滚动对 GitLens、Settings UI、Notebook 等视图完全无效，不要尝试在这些区域启用
最易被忽略的是：同步滚动不是状态持久化功能，它不保存、不继承、不跨组，每次切换编辑器组或关闭重开面板，就得重来一次命令 —— 这不是缺陷，是 VSCode 明确的设计边界。依赖它做长期对照，不如直接用 Compare 视图，省心且功能完整。
