跳转到内容

编辑器

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)。

高亮使用 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 风格键位。

设 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 文件默认在一个写作窗格中打开。内容块原地渲染,点击某块即可在原位置编辑它的 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] 下配置。

本地保存会原子替换文件并保留权限。保存失败会报告,缓冲区保持已修改;关闭未保存的改动、 Close Others/Below 或退出前都会询问。本地文件变化时,干净窗格会作为一次可撤销事务重载; 有未保存修改则询问重载还是保留本地版本;本地文件被删除会报告一次。

远程保存会先比较上次加载或成功保存的原始字节,再通过同目录临时文件替换目标,保留权限并 跟随符号链接;传输失败不会截断原文件。远端已变化时,冲突窗口保留本地编辑并展示两份内容, 可继续编辑、加载远程版本,或用本地内容替换已审阅版本;替换前会再次检查该版本。 这是乐观并发检查,并非针对外部写入者的原子比较交换。远程窗格也会轮询变化:干净缓冲区 重载,有修改时提供冲突审阅。探测或读取失败不会替换缓冲区。超过 2 MiB 的远程文件会被拒绝, 避免打开截断后的可编辑文件。

键 作用
editor Edit in Tab 运行的命令(如 code --wait)
editor-vim 启用最简 vim 模式
mermaid-command 用 mermaid-cli 渲染完整 Mermaid
[lsp] 语言服务器、命令与工作区根目录标记

快捷键列出了窗口、终端和编辑器的按键。


Synced from mttydev/mtty@72b0e56.