编辑器
mtty 把真正的编辑器放在终端旁边,共用同一批标签页和分屏,文件与其构建它的 shell 始终不离开窗口。编辑器构建在 mtty-editor 之上——一个基于 rope、不含 UI 代码的内核,因此同一个引擎也能嵌入别处。编辑通过终端渲染器由 GPU 绘制,这正是超大文件依然流畅的原因。
详情面板的 Files 标签列出当前目录,点击即在阅读器中打开。此外:
- Open Quickly(
⌘⇧O)模糊匹配文件、文件夹、最近文件及其中的文本,也包括标签页、agent 和已保存的主机。 - Open File… 在原生编辑器窗格中打开本地文件。
- Edit in Tab 在终端标签中运行外部编辑器:依次使用
editor设置、$EDITOR、vi(Windows 下是 Notepad)。 - Open Externally 从命令面板把文件交给外部编辑器。
- 跳转到行导航和
file:line参数会在对应行打开窗格。
本地和远程文件都能在窗格中打开;远程文件通过 ssh 读写(见远程主机与 SSH)。
语法与超大文件
Section titled “语法与超大文件”高亮使用 80 个内置的 tree-sitter 语法,支持增量重解析和可见范围查询。没有对应语法的文件回退到 syntect 的 Sublime 语法,以及从 bat 引入的宽松许可语法(Julia、nginx、VHDL、Org 等);状态条上会显示识别出的语言。
体积分级处理,而不是拒绝打开:
| 文件大小 | 行为 |
|---|---|
| ≤ 512 KB | 在 UI 线程解析;按键增量重解析 |
| > 512 KB | 解析移到后台线程,颜色稍后到达 |
| > 8 MB | 为控制内存而停用 tree-sitter;syntect 回退仅处理 1 MB 以内文件,更大的文件使用纯文本 |
| > 64 MB | 以视图模式打开:按窗口从磁盘读取若干行,后台建立稀疏行索引,任意大小下内存都很小 |
视图模式下,输入、粘贴或 Switch to Editing… 会提示载入以进行编辑,并说明将占用的内存(约文件的 2.2 倍)。查找在线程中扫描整个文件。
- 多光标:
⇧⌘L选中全部匹配(从裸光标起按整词),⇧⌥I在每一选中行末加光标,⌥⌘↑/⌥⌘↓增加光标(macOS 之外为Ctrl+Alt+↑/↓)。 - 查找替换:区分大小写、整词、正则;屏幕上每个匹配都会高亮;Replace、Replace All(一步撤销)和 Select All Matches(
⌥↩)。 - Go to Line(
⌃G)接受line:column。 - 常规撤销、重做、缩进、按字素与按词的移动,以及为编辑器保留
⌘D、⇧⌘Z、⇧⌘L的 macOS 风格键位。
Vim 模式
Section titled “Vim 模式”设 editor-vim = true 可启用作用于文档的 vim 状态机:NORMAL / INSERT / VISUAL / VISUAL LINE、计数、h j k l w b e 0 ^ $ gg G、i a I A o O、x、d/c/y 配动作(dd、cc、yy、dw、d$)、带内部寄存器的 p/P、u 与 Ctrl-r、J。/ 打开查找,: 执行 w、q、wq 或跳行;za 系列控制折叠。状态条显示当前模式。
折叠来自语法树(任何跨多行的具名节点),没有语法时按缩进。装订线显示 ▸/▾,折叠的标题以 ⋯ 结尾,上下移动会跳过隐藏行。⌥⌘[ / ⌥⌘] 折叠与展开;Fold All、Unfold All、Toggle Fold 在命令面板里。⌘R 打开可过滤的大纲,按深度嵌套显示文件中的定义。
Markdown 编辑
Section titled “Markdown 编辑”Markdown 文件默认在一个写作窗格中打开。内容块原地渲染,点击某块即可在原位置编辑它的 Markdown 源码;Source / 源码 在同一窗格显示完整源码。撤销、重做及 ⌘S/Ctrl+S 使用原来的 rope 文档、保存和历史链路,也能接收外部重载。
渲染器覆盖标题、列表、引用、表格、代码和链接,相对图片按文档所在目录解析,并渲染 Mermaid 的 graph/flowchart、sequenceDiagram、stateDiagram、classDiagram、erDiagram 和 pie。设 mermaid-command 可调用 mermaid-cli 获得完整 Mermaid。Toggle Markdown Preview 仍可额外打开独立预览窗格;预览随编辑器关闭,并保留在保存的会话中。
本次实现的是块级原地编辑。逐 token 显示源码、高级表格交互及其他写作功能继续由 Markdown 路线图 跟踪。
配置 [lsp] 后,编辑器会在登录 shell 的 PATH 上寻找 rust-analyzer、typescript-language-server、pyright-langserver、gopls 或 clangd 并启动——每种语言分组和工作区根目录一个服务。超过 2 MB 的文件和远程 SSH 窗格不启动语言服务器。
窗格中提供:诊断下划线与状态栏的 ✖/⚠ 计数、指针停留后的悬停、触发字符与词及 Ctrl+Space 的补全(客户端过滤,含片段与 import 编辑)、F12 或 ⌘-点击跳转定义、F8 跳到下一个问题。服务器与根目录标记在 config.toml 的 [lsp] 下配置。
保存与外部改动
Section titled “保存与外部改动”本地保存会原子替换文件并保留权限。保存失败会报告,缓冲区保持已修改;关闭未保存的改动、 Close Others/Below 或退出前都会询问。本地文件变化时,干净窗格会作为一次可撤销事务重载; 有未保存修改则询问重载还是保留本地版本;本地文件被删除会报告一次。
远程保存会先比较上次加载或成功保存的原始字节,再通过同目录临时文件替换目标,保留权限并 跟随符号链接;传输失败不会截断原文件。远端已变化时,冲突窗口保留本地编辑并展示两份内容, 可继续编辑、加载远程版本,或用本地内容替换已审阅版本;替换前会再次检查该版本。 这是乐观并发检查,并非针对外部写入者的原子比较交换。远程窗格也会轮询变化:干净缓冲区 重载,有修改时提供冲突审阅。探测或读取失败不会替换缓冲区。超过 2 MiB 的远程文件会被拒绝, 避免打开截断后的可编辑文件。
配置与快捷键
Section titled “配置与快捷键”| 键 | 作用 |
|---|---|
editor |
Edit in Tab 运行的命令(如 code --wait) |
editor-vim |
启用最简 vim 模式 |
mermaid-command |
用 mermaid-cli 渲染完整 Mermaid |
[lsp] |
语言服务器、命令与工作区根目录标记 |
快捷键列出了窗口、终端和编辑器的按键。
Synced from mttydev/mtty@72b0e56.