scroll_sync 对两个不同文件无效，因其仅支持同一 buffer 的多个视图，不跨文件、不比内容、只按物理行号跳转；需用 compare side-by-side 插件实现基于语义的跨文件同步滚动。
scroll_sync 不起作用，是因为你正在对比两个不同文件——Sublime Text 原生只对同一文件的多个视图生效，跨文件滚动同步必须靠插件或内容感知机制。
为什么 scroll_sync 对两个文件完全无效？
这不是配置漏了，是 Sublime 的底层设计决定的：scroll_sync 只监听同一 buffer 的多个视图（比如用 New View into File 或 Clone File 生成的副本），它不比较内容、不推导语义行对应关系，只按物理行号硬跳转。
- 两个独立文件标签页，哪怕内容一字不差，只要路径不同或打开方式不同（如一个拖入、一个用
subl a.py b.py启动），scroll_sync就静默失效 - 其中一侧启用了
word_wrap而另一侧没开，行高计算偏差会导致视觉错位，看起来像“不同步”，实则是渲染问题 -
scroll_sync在 Sublime Text 4 中默认为false，且不会继承默认设置，必须显式写入用户设置才可能生效（但依然只对同文件有效）
如何让两个不同文件真正同步滚动？
别折腾 scroll_sync，直接装 Compare Side-by-Side 插件——它是目前唯一开箱即用、基于内容相似度动态对齐的方案。
- 安装：命令面板输入
Package Control: Install Package→ 搜Compare Side-by-Side→ 回车 - 启动：两个文件都已打开为标签页后，右键任一标签页 →
Compare Side by Side，或快捷键Ctrl+Alt+C（Win/Linux）/Cmd+Alt+C（macOS） - 滚动是逻辑对齐：左侧滚到某段函数体，右侧自动跳到语义最接近的位置，跳过空行、缩进差异、注释行
- 差异块左侧有箭头图标，点一下就能把整块复制过去，不用手动选中粘贴
分屏布局操作常踩的坑
快捷键 Ctrl+Alt+2 分屏后，第二个文件总覆盖第一个？不是快捷键坏了，是焦点和插入目标没对准。
- 分屏后默认焦点仍在左栏（Group: 0），必须先按
Ctrl+2（Win/Linux）或Cmd+2（macOS）激活右栏，状态栏左下角显示Group: 1才算成功 - 拖文件时不能拖到标签栏边缘或侧边栏，必须拖到右栏「内容区顶部边缘」，等出现实线蓝色插入线再松手
- 误点
Clone File会导致两个视图共享 buffer，一改全改，彻底失去比对意义；正确做法是右键标签 →Move to Group → Right - 输入法处于中文状态时，
Alt+2常被系统劫持，务必切英文输入法再试
大文件或编码不一致时对比失真怎么办？
插件没坏，是文本状态本身干扰了内容匹配——这是最容易被忽略却影响最大的环节。
- 一边是
UTF-8 with BOM，另一边是纯UTF-8：第一行就会全红，误判为整行不同；统一做法是右下角点击编码名 →Convert to UTF-8→ 保存 - 换行符混用（
\r\nvs\n）：导致行号整体偏移，对比块错位；统一用右下角换行符标识 →Convert Line Endings → Unix (LF) - 文件 >5MB 时，Sublime 会静默限流，插件停止监听滚动事件，无任何提示；可先切语法为
Plain Text（命令面板输Set Syntax: Plain Text）减少解析压力 - 用了
Origami或Split Window类插件管理布局？它们可能劫持滚动行为；怀疑冲突时，先禁用测试
word_wrap 这些底层状态。这些细节不调平，再强的插件也白搭。
