Ghostty：配置、主题与终端能力

Ghostty 负责把程序输出绘制到窗口，并把键盘输入交给前台程序。窗口平铺属于桌面合成器，会话保持属于 Zellij，命令补全属于 Shell。排查终端问题时，先确定故障发生在哪一层。

本文配置语法在 Ghostty 1.3.1 下核验。不同平台支持的窗口选项有差异；遇到未知选项，先查看本机版本及其内置说明。

建立最小配置

Linux 下默认 XDG 配置目录通常为 ~/.config/ghostty/。下面保存为该目录下的 config；已有配置先复制一份备份，再逐项合并。

font-family = JetBrains Mono
font-size = 12
background-opacity = 1

字体名称必须与系统识别的家族名称一致。Linux 可先查询：

fc-match 'JetBrains Mono'

输出若是另一个字体，说明发生了回退。中日韩字符和图标也可能使用其他字体；普通等宽字体不一定包含 Nerd Font 图标。

配置使用 key = value，注释必须单独占一行。以下写法可以复制：

# 透明背景由合成器显示，先用不透明配置排除干扰。
background-opacity = 0.92

不要把 # 说明 接在参数值后面，否则它会成为值的一部分。修改后先执行：

ghostty +validate-config

没有配置错误才继续测试窗口。校验通过表示语法和相关配置检查通过，不保证每种字体、协议和平台效果都符合预期。配置语法与路径

透明度、模糊与窗口装饰

透明度允许背景透出；模糊改变背景的视觉细节；窗口装饰决定标题栏和边框。这三项相互关联，但不是同一个设置。

Hyprland 环境可以由合成器统一处理圆角、模糊和窗口移动，Ghostty 只请求不带装饰的窗口：

window-decoration = none

去掉标题栏前，先确认桌面已有移动、缩放和关闭窗口的快捷键。Ghostty 的 background-blur 有平台支持限制，不能假定它在 Hyprland 下与合成器形成两层独立模糊。以参数参考和实际合成器设置为准。

如果终端背景已透明，但 Neovim 的编辑区仍不透明，通常是应用自己绘制了背景色。此时应检查应用配色和终端单元格背景策略，单独调高桌面模糊并不能解决。

从主题文件到窗口颜色

只有 ~/.config/ghostty/themes/MaterialYou 已经存在时，才添加：

theme = MaterialYou

该文件由 Matugen 配色流程生成。“写好文件”和“现有窗口读到新颜色”是两件事：先确认主题文件时间与内容已变化，再通过 Ghostty 的配置重载动作检查当前窗口；某些选项需要重建窗口或重启应用。

排错时可临时改用明确的前景和背景颜色，验证主配置确实被读取，再恢复主题。不要向 Ghostty 发送未经文档确认的 Unix 信号来尝试刷新。旧环境中的 OSC 广播是额外脚本实现的行为，不是 Matugen 自动对所有终端生效的保证。

Shell 集成与 SSH

Shell 集成向终端报告提示符边界、当前目录和命令状态。Ghostty 对支持的 Shell 可自动注入集成脚本；自定义启动方式、远程连接或嵌套 Shell 则需要单独核验。

最直接的检查是：进入一个目录后新建窗口，观察工作目录是否符合预期；执行一条成功和一条失败的命令，观察提示符与相关动作是否正常。若基础命令可执行但目录跟踪失效，优先查集成脚本，不要先修改 PATH 或主题。

SSH 远端还需要认识终端类型：

printf '%s\n' "$TERM"
infocmp "$TERM"

这两条在远端执行。第二条报告 unknown terminal 时，应为远端安装匹配的 terminfo；随意改成另一个 TERM 可能暂时绕过报错，却向程序声明了不准确的能力。剪贴板转发另见 Neovim 远程与输入。

按症状定位

完成配置后，用中文、宽字符、彩色输出和一个全屏程序分别测试。终端渲染正常后，再接入 Zellij，有助于定位后来出现的问题。