设置终端外观
OrcaTerm 支持自定义终端的字体、光标、主题、行间距、渲染模式与背景图等外观。所有外观设置会同步保存至当前登录账号（Web 端云端同步，桌面端未登录时保存到本地），在不同设备登录时保持一致。
Tip
外观设置仅影响 Shell 终端（SSH / TAT / 本地终端），不影响 Windows 远程桌面（RDP）会话。
进入外观设置
-
打开 OrcaTerm
-
点击用户中心中的 设置，打开设置页面，或使用快捷键：
平台 快捷键 macOS Cmd+,Windows / Linux Ctrl+,
- 在左侧菜单选择 外观设置。
主题设置
| 设置项 | 说明 |
|---|---|
| 暗色主题 | 暗色模式下使用的主题。 |
| 亮色主题 | 亮色模式下使用的主题。 |
| 跟随系统 | 是否跟随系统深浅色切换主题。 |
OrcaTerm 内置多套终端主题，覆盖常见配色方案。主题切换会立即应用到所有已打开的终端，同时同步至云端。
字体设置
| 设置项 | 说明 |
|---|---|
| 字体 | 选择可以使用的字体。桌面端默认读取本机字体；Web 端默认提供几个常用字体，也可以使用系统字体。 |
| 字重 | 支持选择斜体、粗体等。 |
| 字号 | 终端字体大小，单位 px。调整后实时生效。 |
字体回退机制
选择字体后，OrcaTerm 会自动拼接默认字体链作为回退，确保 CJK（中日韩）字符也能正常显示：
Note
存储中保留的字体配置在默认字体链升级（如新增字体）后会自动刷新回退链，无需手动重新选择。
行间距
| 设置项 | 说明 |
|---|---|
| 行间距 | 终端行间距倍数，默认 1.0。增大可让命令输出更宽松，便于阅读。 |
Tip
行间距过大会导致终端实际可显示行数减少，按需调整。 行间距变化会触发终端重绘，已打开的终端会立即应用。
光标设置
| 设置项 | 可选值 | 说明 |
|---|---|---|
| 光标形状 | block / underline / bar | 终端光标样式。block 为方块，bar 为竖线，underline 为下划线。 |
| 光标闪烁 | 开 / 关 | 光标是否闪烁。开启后光标以一定频率闪烁。 |
Note
- 光标闪烁由 xterm 的
cursorBlink控制，部分终端程序（如 vim、tmux）可能会接管光标样式，以程序设置为准。 - 光标形状切换仅对新输入生效，已显示的输出不会重绘。
背景设置
| 设置项 | 说明 |
|---|---|
| 背景开关 | 是否启用终端背景图。 |
| 内置背景 | OrcaTerm 提供的预设背景图片。 |
| 自定义背景 | 上传本机图片作为背景。 |
| 适配方式 | 背景图的填充模式。 |
| 透明度 | 背景图透明度，调整背景与终端内容的融合程度。 |
背景图适配方式
| 模式 | 说明 |
|---|---|
| 填充 | 填充整个终端区域 |
| 适应 | 保持比例，可能留白 |
| 拉伸 | 拉伸图片，不裁剪。 |
| 平铺 | 平铺图片，重复填满终端区域。 |
Note
- 启用背景图后，终端背景色会叠加透明度（
${background}00），让背景图透出。 - 自定义背景图存储在账号云端，不同设备登录可同步；图片大小、格式有限制。
- 顶部预览区可实时查看背景图与透明度效果，便于调整。
常见问题
字体修改后部分字符显示异常
- 检查所选字体是否包含 CJK 字符；OrcaTerm 会自动拼接默认字体链作为回退，但若字体本身覆盖异常可能仍有问题。
- 切换到默认字体或常见等宽字体（如 Menlo、Consolas、Monaco）测试。
主题切换后终端颜色未变化
- 已打开的终端需重新渲染才会应用新主题，切换标签页或新开终端即可。
- 检查是否设置了独立的暗色 / 亮色主题，当前应用主题可能与预期不符。
背景图不显示
- 确认背景开关已开启。
- 确认终端背景色未设置过高透明度导致背景图被遮蔽。
- 自定义背景图需上传成功，检查上传是否完成。
WebGL 渲染异常
- 切换渲染模式为 dom。
- 更新浏览器或显卡驱动。
- 部分虚拟机或远程桌面环境不支持 WebGL，需使用 dom 模式。
设置未跨设备同步
- 确认已登录同一账号。
- 桌面端未登录时设置仅保存本地，登录后会合并到云端。