Ghostty 1.4 升级指南：复制选中行为、快捷键和 scrollback 配置要改哪几行

01适用场景

你已经在用 Ghostty 1.3.x，打算升级到 1.4.0，想提前知道哪些配置会受影响；或者升级后发现选中文字不再进剪贴板、快捷键行为不对。

02前提

• macOS 最低仍是 13（Ventura），官方说未来会放弃 13；1.4 已兼容 macOS 27。
• Linux/FreeBSD（GTK 版）需要 GTK 4.18 和 libadwaita 1.7，官方特别提到 Ubuntu 24.04 LTS 不满足，可改用旧版或 Flatpak。
• GTK 版渲染改用 EGL，需要系统有可用的 EGL 库。

03步骤一：恢复被改的默认行为

官方发布说明的“Breaking Changes”列了四项。如果想保持 1.3 的手感，在配置文件里加对应行：

# macOS：恢复 1.3 的选中即复制
copy-on-select = primary

# macOS：保持 Cmd+上下键滚到顶部/底部
keybind = cmd+arrow_up=scroll_to_top
keybind = cmd+arrow_down=scroll_to_bottom

# Linux：把 Ctrl+Shift+上下键还给程序
keybind = ctrl+shift+arrow_up=unbind
keybind = ctrl+shift+arrow_down=unbind

04步骤二：处理已弃用的配置名

• scrollback-limit 改名为 scrollback-limit-bytes，旧名仍能用；新增 scrollback-limit-lines，可按行数限制，两个都设时先到哪个限制就按哪个，都接受 unlimited。
• copy-on-select = true 建议换成 primary（Linux/FreeBSD）或 clipboard（macOS）；false 换成 none。官方说没有移除时间表，但建议尽早改。

05步骤三：留意新的默认值

默认 scrollback 上限从 10 MB 提到 50 MB，原因是不可见的历史会在终端空闲时被压缩，官方称典型文本历史的物理内存占用降低 70% 到 90%；压缩目前只在 macOS 和 64 位 Linux 上可用，可用 scrollback-compression 关掉。官方强调压缩降低的是常驻内存，不是虚拟内存，测量时看常驻内存。

06步骤四：试试 ghostty +ssh

1.4 新增 ghostty +ssh，是个 ssh 包装器：连接前在远端装好 Ghostty 的 terminfo，使用 xterm-ghostty，并转发 COLORTERM、TERM_PROGRAM、TERM_PROGRAM_VERSION，然后照常调用真正的 ssh；远端没有 tic 等导致安装失败时，退回 TERM=xterm-256color。

ghostty +ssh user@example.com

# 想让所有 ssh 都走它
alias ssh='ghostty +ssh --'

# 查看某个配置项的说明（1.4 新增）
ghostty +explain-config font-size

07如何确认升级成功

• 在 macOS 的关于窗口或 Linux 上运行 ghostty +version 看到 1.4.0。
• 选中一段文字，粘贴看是否符合你设定的 copy-on-select 行为。
• 配置有误时 Ghostty 会提示配置错误（macOS 上的配置错误窗口里，回车重载、Esc 忽略）。

08安全相关

官方说明列出了多项安全修复，包括粘贴保护没把回车当行结束符、恶意 Kitty 图形命令可导致崩溃甚至在有限情况下读删临时目录外的文件、tmux 控制模式的崩溃（影响 1.3.0 和 1.3.1）等，还有 macOS 上点击恶意超链接可能执行命令的问题。官方给了各条 GHSA 编号，建议直接升级而不是停在 1.3.x。

09注意事项

• 本文没有在本站环境里运行 Ghostty，配置行均来自官方发布说明，请以你机器上的 ghostty +explain-config 输出为准。
• 官方说明里 Windows 版 Ghostty GUI 已不在路线图，需要的话看 libghostty。