Columns: 2 是查阅 API 文档的最小有效配置,左右栏分别写代码与看文档,需用 DashDoc 命令加载文档而非直接打开文件,并通过 New View into File 实现同文件双栏联动编辑。

Columns: 2 布局是查阅 API 文档的最小有效配置
单列编辑时切回文档再切回代码,光标跳、上下文断、效率掉——直接设为双列是最稳的起点。Columns: 2 把窗口均分为左右两栏,左栏写代码(比如 openapi.yaml 或 Python 调用脚本),右栏放文档(dash_doc 查出的离线页面或本地 Markdown 规范)。别选 Grid: 2x2 或 Columns: 3,四宫格会强制重排所有标签页,三列则多出一栏干扰焦点。
- Windows/Linux 快捷键:
Ctrl+Alt+2;macOS 是Cmd+Alt+2 - 菜单路径:View → Layout → Columns: 2(不是 Groups)
- 如果按了没反应,先切英文输入法,再临时禁用
Origami插件——它常劫持这些组合键
右栏不能靠“打开新窗口”,必须用 DashDoc + Move File to Group
很多人想在右栏直接 Ctrl+P 搜 “react docs” 打开一个 HTML 文件,结果发现无法跳转、不支持搜索、甚至刷新就丢状态。DashDoc 查出的文档页本质是本地服务渲染的临时视图,它只能通过插件命令触发,不能当普通文件打开。
- 正确流程:左栏代码中把光标停在
useState上 → 按自定义快捷键(如Ctrl+Alt+H)→ 文档自动出现在**当前焦点列** - 若文档没进右栏,说明焦点还在左栏:按
Ctrl+2(Win/Linux)或Cmd+2(macOS)激活右栏,再查一次 - 查完后不想关文档?右键该文档标签 →
Move to Group→Group 1(右栏编号从 0 开始)
同一文件双栏联动编辑比“并排看两个文件”更重要
写 OpenAPI 规范时,经常要一边看 /users/{id} 路径定义,一边改对应 Python 请求逻辑。这时候拖两个不同文件到左右栏,不如让同一个 openapi.yaml 在左右栏同步滚动、独立光标——改定义时能立刻看到请求体结构是否匹配。
- 先确保文件已在左栏打开
- 右键该标签 →
New View into File(不是 Clone File) - 按
Ctrl+2切到右栏,再把新视图标签拖进去 - 此时左右栏共用一个 buffer:左边删字段,右边实时消失;但光标位置、折叠状态、滚动偏移各自独立
布局切换后快捷键行为突变,焦点错位是最大隐形坑
很多人切到 Columns: 2 后发现 Ctrl+S 不保存右栏正在编辑的 YAML,而是保存左栏某个没注意的 JS 文件——这不是 bug,是 Sublime 的焦点机制:保存、格式化、运行命令,全以当前焦点列的活动标签页为准,和你眼睛盯着哪栏无关。
确认焦点在哪:看状态栏左下角是否显示 Group: 0 或 Group: 1;没显示就说明焦点丢失,需点击任意标签页手动激活。更麻烦的是 Ctrl+Tab 默认只在当前列内循环,想全局切标签得用 Ctrl+Alt+Tab。这些细节不踩一次很难意识到,但一旦卡住,第一反应不该是重装插件,而是低头看状态栏。

















