Alacritty 终端配置指南

简介

Alacritty 是一个现代终端模拟器，具有合理的默认设置，但允许进行广泛的配置。通过与其他应用程序集成，而不是重新实现它们的功能，它能够提供一套灵活的高性能特性。目前支持的平台包括 BSD、Linux、macOS 和 Windows。

安装

如果不需要修改图标推荐直接下载

• 直接下载官网编译的安装包 https://alacritty.org/index.html

• 手动编译 这里因为源代码的图标是方形直角, 并且和 macOS 的图标风格不太搭配, 所以我自己 fork 了一份修改了图标, 所以需要手动编译

安装 rust 和 make 环境

bash
# 安装 rust 环境, 如果已存在则可以跳过
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

brew install make

bash
 # 浅克隆仓库代码
git clone --depth 1 https://github.com/KevinYouu/alacritty.git

cd alacritty

# 编译当前架构
make dmg

# 编译 macOS 的通用架构
# dmg-universal

然后可以在 alacritty/target/release/osx 这个目录找到编译好的 app 和 dmg 文件, 直接放入 /Applications 即可使用

配置

这是我的自定义配置文件

toml
[window]
dimensions = { columns = 80, lines = 24 }
padding = { x = 4, y = 0 }
opacity = 0.2
blur = true

[font]
normal = { family = "Roboto Mono", style = "Regular" }
bold = { family = "Roboto Mono", style = "bold" }
italic = { family = "Roboto Mono", style = "italic" }
bold_italic = { family = "Roboto Mono", style = "bold italic" }
size = 18

[selection]
save_to_clipboard = true
semantic_escape_chars = ",│`|:\"' ()[]{}<>\t"

[cursor]
style = { shape = "Beam", blinking = "On" }

[terminal]
shell = { program = "/opt/homebrew/bin/fish", args = ["-l"] }

[colors.primary]
foreground = "#ffffff" # 白色
background = "#000000" # 黑色

[colors.normal]
black = "#000000"
red = "#ff3b30"
green = "#4cd964"
yellow = "#ffcc00"
blue = "#007aff"
magenta = "#ff2d55"
cyan = "#5ac8fa"
white = "#ffffff"

[colors.bright]
black = "#686868"
red = "#ff3b30"
green = "#4cd964"
yellow = "#ffcc00"
blue = "#007aff"
magenta = "#ff2d55"
cyan = "#5ac8fa"
white = "#ffffff"

[keyboard]
bindings = [
    # 复制 (Cmd + C)
    { key = "C", mods = "Command", action = "Copy" },

    # 粘贴 (Cmd + V)
    { key = "V", mods = "Command", action = "Paste" },

    # 查找 (Cmd + F)
    { key = "F", mods = "Command", action = "SearchForward" },

    # 新建窗口 (Cmd + N)
    { key = "N", mods = "Command", action = "CreateNewWindow" },

    # 缩小字体 (Cmd + -)
    { key = "Minus", mods = "Command", action = "DecreaseFontSize" },

    # 放大字体 (Cmd + =)
    { key = "Equals", mods = "Command", action = "IncreaseFontSize" },

    # 恢复默认字体大小 (Cmd + 0)
    { key = "Key0", mods = "Command", action = "ResetFontSize" },

    # 切换全屏 (Cmd + Enter)
    { key = "Return", mods = "Command", action = "ToggleSimpleFullscreen" },

    # 切换到具体标签页 (Cmd + 1 ~ Cmd + 9)
    { key = "Key1", mods = "Command", action = "SelectTab1" },
    { key = "Key2", mods = "Command", action = "SelectTab2" },
    { key = "Key3", mods = "Command", action = "SelectTab3" },
    { key = "Key4", mods = "Command", action = "SelectTab4" },
    { key = "Key5", mods = "Command", action = "SelectTab5" },
    { key = "Key6", mods = "Command", action = "SelectTab6" },
    { key = "Key7", mods = "Command", action = "SelectTab7" },
    { key = "Key8", mods = "Command", action = "SelectTab8" },
    { key = "Key9", mods = "Command", action = "SelectTab9" },

    # 隐藏 Alacritty (Cmd + H)
    { key = "H", mods = "Command", action = "Hide" },

    # 隐藏其他应用 (Cmd + Option + H)
    { key = "H", mods = "Command|Option", action = "HideOtherApplications" },
]

效果预览

完整配置文档

语法

Alacritty 的配置文件使用 TOML 格式。其规范可以在 https://toml.io/en/v1.0.0 找到。

配置文件位置

Alacritty 不会自动创建配置文件，但它会在特定位置查找该文件。

UNIX 系统:

1. $XDG_CONFIG_HOME/alacritty/alacritty.toml
2. $XDG_CONFIG_HOME/alacritty.toml
3. $HOME/.config/alacritty/alacritty.toml
4. $HOME/.alacritty.toml

Windows 系统:

1. %APPDATA%\alacritty\alacritty.toml

[general] - 通用配置

import

• 格式: ["<string>", ...]
• 作用: 导入额外的配置文件。文件会按顺序加载，最后加载主配置文件，后加载的配置会覆盖之前的配置。导入路径可以是绝对路径、相对于用户主目录 (~/) 的路径，或相对于当前配置文件的路径。
• 示例:

  toml
  import = [
    "~/.config/alacritty/base16-dark.toml",
    "~/.config/alacritty/keybindings.toml",
  ]
  

working_directory

• 格式: "<string>" 或 "None"
• 作用: 指定 Shell 的启动目录。如果设为 "None" 或未设置，将使用父进程的工作目录。
• Default: "None"

live_config_reload

• 格式: true | false
• 作用: 启用或禁用实时配置重载功能。
• Default: true

ipc_socket

• 格式: true | false
• 作用: 启用或禁用通过 alacritty msg 进行 IPC (进程间通信)。
• 平台: 仅限 Unix。
• Default: true

[env] - 环境变量

在此部分中定义的所有键值对，都将作为环境变量添加到由 Alacritty 启动的任何进程中（包括其 Shell）。

• 示例:

  toml
  [env]
  WINIT_X11_SCALE_FACTOR = "1.0"
  

[window] - 窗口配置

dimensions

• 格式: { columns = <integer>, lines = <integer> }
• 作用: 设置窗口启动时的尺寸（以字符列数和行数计算）。此配置需要重启 Alacritty 才能生效。columns 必须至少为 2。
• Default: { columns = 0, lines = 0 }

position

• 格式: { x = <integer>, y = <integer> } 或 "None"
• 作用: 设置窗口启动时的位置（以像素为单位）。如果设为 "None"，则由窗口管理器决定位置。
• 平台: 在 Wayland 上无效。
• Default: "None"

padding

• 格式: { x = <integer>, y = <integer> }
• 作用: 在窗口内容周围添加的空白边距（以像素为单位），该值会根据 DPI 进行缩放。
• Default: { x = 0, y = 0 }

dynamic_padding

• 格式: true | false
• 作用: 当窗口尺寸不是单元格大小的整数倍时，是否将额外的填充均匀地分布在终端内容周围。
• Default: false

decorations

• 格式: "Full" | "None" | "Transparent" | "Buttonless"
• 作用: 设置窗口装饰（边框和标题栏）。
  • Full: 完整边框和标题栏。
  • None: 无边框和标题栏。
  • Transparent (仅限 macOS): 透明背景的标题栏和按钮。
  • Buttonless (仅限 macOS): 透明背景的标题栏但无按钮。
• Default: "Full"

opacity

• 格式: <float>
• 作用: 背景不透明度，取值范围为 0.0 (完全透明) 到 1.0 (完全不透明)。
• Default: 1.0

blur

• 格式: true | false
• 作用: 请求混成器模糊透明窗口后面的内容。
• 平台: 在 macOS/KDE Wayland 上有效。
• Default: false

startup_mode

• 格式: "Windowed" | "Maximized" | "Fullscreen" | "SimpleFullscreen"
• 作用: 窗口启动模式，需要重启才能生效。
  • Windowed: 普通窗口。
  • Maximized: 启动时最大化。
  • Fullscreen: 启动时全屏。
  • SimpleFullscreen (仅限 macOS): 与 Fullscreen 类似，但允许其他窗口堆叠在其上。
• Default: "Windowed"

title

• 格式: "<string>"
• 作用: 设置窗口标题。
• Default: "Alacritty"

dynamic_title

• 格式: true | false
• 作用: 是否允许终端内的应用程序通过转义序列更改 Alacritty 的窗口标题。
• Default: true

class

• 格式: { instance = "<string>", general = "<string>" }
• 作用: 设置窗口类（Window class）。在 Wayland 上, general 用作 app_id。
• 平台: 仅限 Linux/BSD。
• Default: { instance = "Alacritty", general = "Alacritty" }

decorations_theme_variant

• 格式: "Dark" | "Light" | "None"
• 作用: 覆盖系统主题或 Wayland 客户端装饰的变体。设为 "None" 使用系统默认值。
• Default: "None"

resize_increments

• 格式: true | false
• 作用: 调整窗口大小时，是否以单个单元格的尺寸为步长进行离散调整。
• 平台: 在 macOS/X11 上有效。
• Default: false

option_as_alt

• 格式: "OnlyLeft" | "OnlyRight" | "Both" | "None"
• 作用: 将 Option 键映射为 Alt 键。
• 平台: 仅限 macOS。
• Default: "None"

level

• 格式: "Normal" | "AlwaysOnTop"
• 作用: 设置窗口层级。
  • Normal: 窗口遵守系统默认的 Z 轴顺序。
  • AlwaysOnTop: 窗口始终位于顶层。
• Default: "Normal"

[scrolling] - 滚动配置

history

• 格式: <integer>
• 作用: 设定回滚缓冲区的最大行数。设为 0 将禁用滚动。最大限制为 100000。
• Default: 10000

multiplier

• 格式: <integer>
• 作用: 每次滚动输入（如滚动鼠标滚轮）所滚动的行数。
• Default: 3

[font] - 字体配置

normal

• 格式: { family = "<string>", style = "<string>" }
• Default:
  • Linux/BSD: { family = "monospace", style = "Regular" }
  • Windows: { family = "Consolas", style = "Regular" }
  • macOS: { family = "Menlo", style = "Regular" }

bold

• 格式: { family = "<string>", style = "<string>" }
• 作用: 粗体文本的字体配置。如果未指定 family，将使用 normal 的字体族。
• Default: { style = "Bold" }

italic

• 格式: { family = "<string>", style = "<string>" }
• 作用: 斜体文本的字体配置。如果未指定 family，将使用 normal 的字体族。
• Default: { style = "Italic" }

bold_italic

• 格式: { family = "<string>", style = "<string>" }
• 作用: 粗斜体文本的字体配置。如果未指定 family，将使用 normal 的字体族。
• Default: { style = "Bold Italic" }

size

• 格式: <float>
• 作用: 字体大小（以磅为单位）。
• Default: 11.25

offset

• 格式: { x = <integer>, y = <integer> }
• 作用: 每个字符周围的额外空间。y 用于调整行间距，x 用于调整字间距。
• Default: { x = 0, y = 0 }

glyph_offset

• 格式: { x = <integer>, y = <integer> }
• 作用: 调整字形在单元格内的位置。x 增加向右移动，y 增加向上移动。

builtin_box_drawing

• 格式: true | false
• 作用: 当为 true 时，Alacritty 将使用内置字体来绘制制表符 (U+2500 - U+259F)、旧式计算符号 (U+1FB00 - U+1FB3B) 和 Powerline 符号 (U+E0B0 - U+E0B3)。
• Default: true

[colors] - 颜色配置

颜色使用 #RRGGBB 格式的十六进制值指定。

primary

• 作用: 主色调，包括默认的前景色和背景色。
  • foreground: 默认 "#d8d8d8"。
  • background: 默认 "#181818"。
  • dim_foreground: 默认 "#828482"。如果未设置，将基于前景色自动计算。
  • bright_foreground: 默认 "None"。仅在 draw_bold_text_with_bright_colors 为 true 时使用。

cursor

• 格式: { text = "<string>", cursor = "<string>" }
• 作用: 光标颜色。值可以是十六进制颜色或特殊值 CellForeground/CellBackground。
• Default: { text = "CellBackground", cursor = "CellForeground" }

selection

• 格式: { text = "<string>", background = "<string>" }
• 作用: 文本选择区域的颜色。
• Default: { text = "CellBackground", background = "CellForeground" }

normal

• 作用: 8 种标准颜色。
  • black: "#181818"
  • red: "#ac4242"
  • green: "#90a959"
  • yellow: "#f4bf75"
  • blue: "#6a9fb5"
  • magenta: "#aa759f"
  • cyan: "#75b5aa"
  • white: "#d8d8d8"

bright

• 作用: 8 种亮色。
  • black: "#6b6b6b"
  • red: "#c55555"
  • green: "#aac474"
  • yellow: "#feca88"
  • blue: "#82b8c8"
  • magenta: "#c28cb8"
  • cyan: "#93d3c3"
  • white: "#f8f8f8"

draw_bold_text_with_bright_colors

• 格式: true | false
• 作用: 当设置为 true 时，粗体文本将使用 bright 部分定义的亮色进行渲染。
• Default: false

[cursor] - 光标配置

style

• 作用: 定义光标的形状和闪烁行为。
  • shape: 可选值为 "Block", "Underline", "Beam"。默认 "Block"。
  • blinking: 可选值为 "Never", "Off", "On", "Always"。默认 "Off"。

unfocused_hollow

• 格式: true | false
• 作用: 当窗口未聚焦时，是否将光标渲染为空心方块。
• Default: true

thickness

• 格式: <float>
• 作用: 光标的厚度，是相对于单元格宽度的浮点数，范围从 0.0 到 1.0。
• Default: 0.15

[keyboard] - 键盘绑定

bindings

• 格式: [{ key = "<key>", mods = "<mods>", action = "<action>" | ... }, ...]
• 作用: 定义一个包含多个键盘绑定的数组。要取消默认绑定，可将 action 设置为 "ReceiveChar" 或 "None"。
• 字段:
  • key: 按键名称 (例如 "A", "F1") 或按键的 scancode。
  • mods: 修饰键 ("Control", "Shift", "Alt", "Super", "Command")，多个修饰键用 | 分隔。
  • mode: 绑定生效的终端模式 (如 "Vi", "Search")。
  • action: 预定义的动作，如 Paste, Copy, ToggleFullscreen 等。
  • chars: 向终端写入指定的字符串。
  • command: 执行一个外部命令。
• 示例:

  toml
  [[keyboard.bindings]]
  key = "N"
  mods = "Control|Shift"
  action = "CreateNewWindow"
  

[debug] - 调试配置

这些选项用于帮助排查问题，其功能和可用性可能会在没有警告的情况下更改。

persistent_logging

• 格式: true | false
• 作用: 退出 Alacritty 后是否保留日志文件。
• Default: false

log_level

• 格式: "Off" | "Error" | "Warn" | "Info" | "Debug" | "Trace"
• 作用: 设置日志记录级别。
• Default: "Warn"

renderer

• 格式: "glsl3" | "gles2" | "gles2pure" | "None"
• 作用: 强制使用特定的渲染器。"None" 将使用可用的最高级渲染器。
• Default: "None"

参考链接

• 官方文档
• 下载地址
• rust 文档