Origami插件在Sublime Text 4.4+中已不可靠,应弃用;原生set_layout命令更稳定、参数清晰、跨平台一致,且完全覆盖其所有分屏功能,原因包括:依赖旧API失效、direction大小写敏感、动态重排不可预测、配置容错率低。

Origami 插件在 Sublime Text 4.4+(当前主流版本)中已不可靠,不建议安装;原生 set_layout 命令更稳定、参数清晰、跨平台一致,且完全覆盖其所有分屏功能。
为什么 origami_create_pane 经常没反应
这不是你配错了快捷键,而是插件底层已失效:
• origami_create_pane 依赖 Sublime Text 旧版布局 API,而自 Build 4123(2022 年起)起,内核已重构为 cols/rows/cells 三元组机制
• direction 参数只接受小写字符串(如 "right"),写成 "Right" 或 "RIGHT" 会静默失败
• 动态重排逻辑在嵌套布局中不可预测,容易导致 cells 越界、窗格空白或坐标错位
• 安装后默认无任何快捷键,所有绑定都要手动加 JSON,格式稍错(比如多逗号、缺引号)就整个配置失效
用原生 set_layout 实现任意分屏
所有分屏本质都是定义三件事:cols(列边界)、rows(行边界)、cells(每个窗格的坐标)。例如左右等宽双栏:
• 打开 Preferences → Key Bindings(用户配置)
• 粘贴以下内容:
[ {"keys": ["ctrl+alt+2"], "command": "set_layout", "args": {"cols": [0.0, 0.5, 1.0], "rows": [0.0, 1.0], "cells": [[0, 0, 1, 1], [1, 0, 2, 1]] } } ]•
cols 长度决定列数([0.0, 0.5, 1.0] = 2 列),rows 长度决定行数([0.0, 1.0] = 1 行)•
cells 每项是 [left, top, right, bottom],索引从 0 开始,顺序不能错• 保存即生效,无需重启,也无需插件
文件进不了目标窗格?焦点根本没切过去
这是 90% 的“分屏失败”真实原因,和插件无关:
• 状态栏左下角显示 Group: 0 表示焦点在第一个窗格,Group: 1 才是第二个
• 按 Ctrl+2(Windows/Linux)或 Cmd+2(macOS)强制切换焦点,比鼠标点击更可靠
• 切换后,再按 Ctrl+P 搜索打开文件,它会自动落入当前焦点 Group
• 右键文件标签 → Move to Group → 1(编号从 0 开始),比拖拽容错率高得多
• 别用 Clone File:它创建的是同一文件的两个镜像视图,改左边右边自动同步,不是对比
上下 vs 左右分屏:选法取决于操作意图
性能无差异,但误操作成本不同:
• 上下布局(Ctrl+Alt+8)适合纵向对照长文件,比如上半区看函数实现、下半区看测试用例
• 左右布局(Ctrl+Alt+2)更适合横向对比不同文件,如前后端接口定义
• 上下分屏时滚动条独立,不能联动;左右分屏时鼠标滚轮容易误触右侧面板滚动条
• 若需嵌套(如右栏再上下分),直接写死 cols 和 rows,例如:"cols": [0.0, 0.6, 1.0], "rows": [0.0, 0.5, 1.0],但必须保证 cells 坐标不越界
set_layout 的参数容错率远高于任何插件——而这一点,恰恰最容易被忽略。


















