• 开发工具
• CLI

Delta（一个用于 git、diff、grep、rg --json与 blame 输出的语法高亮分页器）最强大的能力之一，就是通过统一而灵活的"样式字符串"（style string）控制 diff 中每一个元素的配色与装饰。本文以 manual/src/choosing-colors-styles.md 为主线，结合 manual/src/full---help-output.md 中的STYLES、COLORS章节以及仓库源码，系统讲解 delta 的深色/浅色自动检测机制、样式字符串的完整语法、四种颜色书写方式、装饰样式（box/ul/ol）与实验调色工具，读完即可为你的git diff输出定制一套专属配色方案。

一、先理解 delta 的着色模型：dark / light 自动检测

delta 会自动探测终端的背景色，并据此选择一套合适的默认颜色。这套默认配色并非简单的黑底白字，而是一组经过调校的语义色：删除行（minus）使用偏红的背景、新增行（plus）使用偏绿的背景、被强调的增删片段（emph）使用更饱和的同色系背景。

在源码 src/color.rs 中，这个决策被建模为一个ColorMode枚举：

pub enum ColorMode { /// Dark background with light text. Dark, // 默认值 /// Light background with dark text. Light, }

该枚举直接决定 delta 选择的默认增删背景色。以"暗色主题、支持 24 位真彩色"为例，src/color.rs 中定义的实际色值为：

当终端不支持真彩色时，delta 会退回到对应的 256 色近似值（如Fixed(52)、Fixed(22)），具体映射同样定义在 src/color.rs。

手动覆盖自动检测：dark = true/light = true

自动探测在大多数场景下可靠，但在某些包装了 delta 的上下文（如lazygit、zellij）中可能失效，因为此时 delta 无法可靠地从终端获取背景色。此时需要手动指定：

[delta] dark = true

对应的命令行选项是--dark与--light（manual/src/full---help-output.md 中注明其默认样式"适用于深/浅色终端背景"）。三者关系为：--dark/--light一旦指定，自动探测即被忽略。

底层探测开关：--detect-dark-light

自动探测并非"猜"，而是 delta查询终端颜色得到的。该行为由--detect-dark-light控制，取值与语义如下：

• auto（默认）：仅当输出未重定向时才查询终端颜色；
• always：总是查询；
• never：从不查询。

为什么默认是auto？因为查询终端颜色需要"独占"终端访问（delta 要读写终端并启停 raw mode），当输出被手动管道给分页器时（如git diff | delta | less）会与less产生竞态。而 delta 自行启动分页器时则无此问题——颜色检测发生在分页器启动之前。此外，--color-only会被视为interactive.diffFilter的指示器：即使输出被重定向，也会查询终端颜色。这些细节都记录在 manual/src/full---help-output.md 的--detect-dark-light条目中。

与真彩色（true color）的关系

暗/亮模式只决定"哪套默认色"，而颜色以什么精度输出由--true-color（旧名--24-bit-color，已废弃）决定：auto（默认，依据COLORTERM=truecolor或24bit环境变量）、always、never。源码parse_color的最后一个参数true_color正是传递给底层 ANSI 转换的关键（见 src/color.rs）。

二、样式字符串（Style String）语法：所有--*-style选项的统一语言

delta 中所有名字形如--*-style的选项都以完全相同的方式工作，其语法与 git config 中颜色的写法高度相似。这是整个配色体系的核心约定，官方文档在 manual/src/choosing-colors-styles.md 与 manual/src/full---help-output.md 的STYLES章节中反复强调。

一个完整的例子

[delta] minus-style = red bold ul "#ffeeee"

含义：对于删除行，将前景（文字）颜色设为red，加粗（bold）并加下划线（ul），背景色设为#ffeeee。

在命令行上等价写法为：

delta --minus-style 'red bold ul "#ffeeee"'

语法规则（来自STYLES章节，逐条展开）

1. 结构：一个样式字符串由 0、1 或 2 个颜色加上任意数量的样式属性组成，全部以空格分隔。
2. 位置顺序：第一个颜色是前景（文字）色，第二个颜色是背景色。属性可以出现在任意位置。
3. 关键约束：要指定背景色，必须同时指定前景色（因为解析器按位置判断"第二个颜色是背景"）。
4. 特殊颜色auto：让 delta 自动选择该颜色，可用于前景与背景。
5. 特殊颜色normal：使用你终端本身的前景色/背景色。
6. 特殊颜色syntax：前景文字按语言进行语法高亮。只能用作前景色（源码 src/parse_style.rs 中，若将syntax用作第二个（背景）颜色会直接fatal报错）。
7. 特殊颜色raw：若 delta 接收到的输入本身已带颜色，用raw可让这些颜色原样透传；否则 delta 会剥掉输入中的颜色。
8. 空字符串''：最小样式规范，表示"不对此元素应用任何颜色或样式"。

可用属性（Attributes）

blink、bold、dim、hidden、italic、reverse、strike，以及ul（或全称underline）。源码 src/parse_style.rs 的parse_ansi_term_style逐词解析这些关键字，并将ul/underline视为同一属性；style.rs的Display实现则按固定顺序回写属性名（src/style.rs）。

特殊属性omit

commit-style、file-style、hunk-header-style三个选项支持omit属性，表示将该元素整体从输出中移除。例如file-style = omit可隐藏文件头。解析器同样在 src/parse_style.rs 中处理。

组合示例：特殊颜色 + 单个属性

--minus-style 'syntax bold auto'

含义：删除行文字做语法高亮（syntax），加粗（bold），背景交给 delta 默认处理（auto）。

gitconfig 中的引号约定

在~/.gitconfig中，样式字符串值需要用双引号包裹，例如minus-style = "syntax #340001"；而主题名等值不要加引号（会原样传给 delta），例如theme = Monokai Extended。此约定在 manual/src/configuration.md 中有明确提示。

源码级的解析细节

从 src/parse_style.rs 可以确认以下实现事实：

• 解析前会统一转小写，因此Bold、BOLD与bold等价；
• 每个词会去除首尾的引号（"或'），所以带引号的"#ffeeee"能正确解析；
• 超过两个颜色词会触发致命错误，提示参见delta --help的 STYLES 章节；
• 属性关键字有blink/bold/dim/hidden/italic/omit/reverse/raw/strike/ul/underline，其中line-number、file、omit-code-fragment是hunk-header-style专用的特殊词（被解析器放行）。

测试用例见 src/parse_style.rs：例如parse_ansi_term_style("bold red underline green blink", ...)断言得到"前景红、背景绿、加粗、下划线、闪烁"的组合，直接印证了上述语法。

三、颜色（Colors）的四种写法

在样式字符串内部，颜色本身有四种指定方式（对应 manual/src/full---help-output.md 的COLORS章节）：

1. CSS 颜色名

任意一种 CSS 规范中的 140 个颜色名。源码 src/color.rs 通过 syntect 的syntect_color_from_name解析这些名称。

2. RGB 十六进制码

--file-style="#0e7c0e"

src/color.rs 中以#开头的字符串直接交给SyntectColor::from_str解析，非法值会触发fatal("Invalid color or style attribute: ...")。

3. ANSI 颜色名

共 8 个基础名：black、red、green、yellow、blue、magenta、cyan、white，以及各自的明亮形式：brightblack、brightred、brightgreen、brightyellow、brightblue、brightmagenta、brightcyan、brightwhite。

ANSI 颜色名的特殊价值在于：它们是"名字"而非"固定色值"——你可以在终端应用的设置中决定每个名字对应的具体颜色。这样当你更换终端主题时，delta 的配色会自动跟随，无需改动 delta 配置。这是选择 ANSI 名称而非十六进制码的核心理由。

实现上，src/color.rs 维护了一张ANSI_16_COLORS映射表，其中purple被登记为magenta的同义词（值同为 5），且同时接受bright-purple等带连字符变体；颜色名与代码均不区分大小写。

4. ANSI 颜色编号

--file-style=28

0–255 的 256 色编号。前 16 个编号与上文的 ANSI 颜色名一一对应。当你的终端只支持 256 色（不支持 24 位真彩）时，用编号指定颜色非常有用。解析路径在 src/color.rs：先尝试解析为u8，再映射为 syntect 颜色；否则回退到名称解析。

补充：样式值还会先查询 git config 中delta.<颜色名>键（src/color.rs），这意味着你可以把自定义颜色定义在 gitconfig 中再引用。

想浏览全部可用颜色，运行delta --show-colors。除了命名颜色，任意颜色都可以用 RGB 十六进制码指定（见--show-colors的说明）。

四、装饰（Decoration）样式：box / ul / ol

除行内容本身外，delta 还有一类"装饰样式"选项，负责给文件头、hunk 头、commit 行等绘制**边框（box）、下划线（ul）、上划线（ol）**等装饰。这类选项包括：

• --commit-decoration-style
• --file-decoration-style
• --hunk-header-decoration-style
• --grep-header-decoration-style
• --merge-conflict-ours-diff-header-decoration-style/--merge-conflict-theirs-diff-header-decoration-style

样式字符串中应包含特殊属性box、ul（下划线）、ol（上划线）或其组合ul ol。在源码 src/style.rs 中，DecorationStyle枚举覆盖了全部组合：

pub enum DecorationStyle { Box(ansi_term::Style), Underline(ansi_term::Style), Overline(ansi_term::Style), UnderOverline(ansi_term::Style), BoxWithUnderline(ansi_term::Style), BoxWithOverline(ansi_term::Style), BoxWithUnderOverline(ansi_term::Style), NoDecoration, // 默认 }

解析逻辑位于 src/parse_style.rs：box/ul/ol会被从普通样式字符串中提取出来，组合成对应的DecorationStyle变体（none/plain则表示无装饰）。注意：在普通行样式中ul是文字属性（下划线），只有出现在装饰样式字符串中时才表示"下划线装饰"，两者的歧义正是由 src/parse_style.rs 中的is_decoration_style_string标志消解的。

各装饰选项的默认值（来自 manual/src/full---help-output.md）：

例如，给 hunk 头加上黄色圆角边框风格的醒目装饰可以写：

[delta] hunk-header-decoration-style = yellow box

（该示例取自 manual/src/features-named-groups-of-settings.md 中的 "decorations" 特性。）

五、行级样式的完整应用面：从 minus/plus 到各 diff 元素

掌握了样式字符串语法后，可以套用到 delta 的几乎每一个元素上。以下是 manual/src/full---help-output.md 中与样式直接相关的选项及其默认值汇总：

注意默认值中蕴含的设计：plus-style与zero-style默认使用syntax，即新增行与未改动行默认会做语法高亮，而minus-style默认不启用语法高亮。

行内（within-line）高亮的配套样式

minus-emph-style/plus-emph-style是行内 diff 算法（manual/src/features.md 中介绍）识别出的"词级增删片段"。相关参数还有--max-line-distance（默认 0.6，决定两行是否同源）、--word-diff-regex（默认\w+，定义"词"）与--line-buffer-size（默认 32，控制参与行内对比的缓冲行数），均可在 manual/src/full---help-output.md 中查到。

映射已有颜色：--map-styles

如果输入本身带颜色（如git diff --color-moved的移动标记色、grep --color的匹配色），可以用--map-styles将输入样式映射为期望的输出样式：

--map-styles='bold purple => red "#eeeeee", bold cyan => syntax "#eeeeee"'

配合git show --color=always | delta --parse-ansi可把输入中的 ANSI 转义序列以人类可读形式打印出来，帮助你识别需要映射的输入样式串。

六、实验与调色工具：show-config / show-colors / show-themes / show-syntax-themes

调试配色不必反复改配置再看 diff，delta 提供了四个实验命令：

1. delta --show-config：显示所有 delta 选项的当前生效值，其中样式字符串选项会同时以前景/背景色渲染出来。可以叠加其他选项做实时实验，例如：

   delta --show-config --minus-style 'red bold ul "#ffeeee"' --dark

2. delta --show-colors：列出所有可用的命名颜色，方便挑选 CSS 名 / ANSI 名 / 编号。
3. delta --show-syntax-themes：用一段示例 diff 展示所有语法高亮主题。可喂入你自己的 diff 预览效果：git show | delta --show-syntax-themes。语法主题由--syntax-theme指定，默认取BAT_THEME环境变量，--syntax-theme=none关闭语法高亮。
4. delta --show-themes：展示 delta 自身定义的"主题"（即一组命名 feature）。默认只显示与当前暗/亮模式匹配的主题，可用--dark/--light（或同时给出）控制展示范围。

仓库根目录的 themes.gitconfig 是一份由社区维护的主题合集（如colibri、collared-trogon）。其头部注释给出了主题的创作规范：必须用某种野生生物命名；只保留与外观相关的必要设置；必须包含dark = true或light = true以标记为"主题"（这样才会被--show-themes拾取）。

这一"主题即 feature + 暗/亮标记"的机制在源码中得到印证：src/options/get.rs 用正则^delta\.(.+)\.(light|dark)$从 gitconfig 中识别主题名，单元测试test_get_themes_from_config（src/options/get.rs）验证了dark-theme、light-and-dark-theme、Uppercase-Theme能被正确识别，而仅含max-line-distance的普通 feature 不会被当作主题。

使用主题的方法（详见 manual/src/custom-themes.md）：

[include] path = /PATH/TO/delta/themes.gitconfig [delta] features = collared-trogon side-by-side = true

七、综合实战：一套完整的自定义配色配置

综合本文全部知识，一个同时覆盖暗色终端、自定义增删配色、装饰与主题的完整~/.gitconfig示例：

[core] pager = delta [interactive] diffFilter = delta --color-only [delta] # 深色终端（在 lazygit / zellij 等环境中务必手动指定） dark = true # 删除行：红字加粗下划线 + 浅红背景 minus-style = red bold ul "#ffeeee" # 新增行：语法高亮 + 浅绿背景 plus-style = syntax "#e6ffe6" # 强调片段（行内增删词） minus-emph-style = red bold "#ffc0c0" plus-emph-style = syntax bold "#b0ffb0" # 未改动行 zero-style = syntax normal # 装饰 file-decoration-style = blue ul hunk-header-decoration-style = yellow box commit-style = yellow bold # 行号与导航 line-numbers = true navigate = true [merge] conflictStyle = zdiff3

几点实战提醒：

• 样式值在 gitconfig 中要用双引号，如minus-style = "syntax #340001"；命令行则用单引号包裹避免 shell 展开。
• 想临时覆盖某项配置，用git -c：git -c delta.line-numbers=false show（来自 manual/src/configuration.md）。
• 若只想做颜色叠加、不做结构改动，用interactive.diffFilter = delta --color-only让 delta 作为纯着色器服务其他工具。
• 将配置从 git config 中拆出独立管理，可用GIT_CONFIG_GLOBAL环境变量指向独立的 delta 配置文件（manual/src/configuration.md）。

八、常见取舍速查

更多细节与完整参数表，可直接查阅 manual/src/full---help-output.md 的STYLES、COLORS与各选项条目；如果想了解如何把这些样式组织成可复用的命名分组，参见 manual/src/features-named-groups-of-settings.md。

• 开发工具
• CLI