开发工具CLI【免费下载链接】deltaA syntax-highlighting pager for git, diff, grep, rg --json, and blame output项目地址https://gitcode.com/gh_mirrors/de/delta点击查看免费下载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 中定义的实际色值为元素暗色主题true color亮色主题true color删除行背景minus#3f0001近似 #52 的 256 色#ffe0e0删除强调片段minus-emph#901011#ffc0c0新增行背景plus#002800#d0ffd0新增强调片段plus-emph#006000#a0efa0当终端不支持真彩色时delta 会退回到对应的 256 色近似值如Fixed(52)、Fixed(22)具体映射同样定义在 src/color.rs。手动覆盖自动检测dark true/light true自动探测在大多数场景下可靠但在某些包装了 delta 的上下文如lazygit、zellij中可能失效因为此时 delta 无法可靠地从终端获取背景色。此时需要手动指定[delta] dark true对应的命令行选项是--dark与--lightmanual/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默认依据COLORTERMtruecolor或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章节逐条展开结构一个样式字符串由 0、1 或 2 个颜色加上任意数量的样式属性组成全部以空格分隔。位置顺序第一个颜色是前景文字色第二个颜色是背景色。属性可以出现在任意位置。关键约束要指定背景色必须同时指定前景色因为解析器按位置判断第二个颜色是背景。特殊颜色auto让 delta 自动选择该颜色可用于前景与背景。特殊颜色normal使用你终端本身的前景色/背景色。特殊颜色syntax前景文字按语言进行语法高亮。只能用作前景色源码 src/parse_style.rs 中若将syntax用作第二个背景颜色会直接fatal报错。特殊颜色raw若 delta 接收到的输入本身已带颜色用raw可让这些颜色原样透传否则 delta 会剥掉输入中的颜色。空字符串最小样式规范表示不对此元素应用任何颜色或样式。可用属性Attributesblink、bold、dim、hidden、italic、reverse、strike以及ul或全称underline。源码 src/parse_style.rs 的parse_ansi_term_style逐词解析这些关键字并将ul/underline视为同一属性style.rs的Display实现则按固定顺序回写属性名src/style.rs。特殊属性omitcommit-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#0e7c0esrc/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-style280–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.rsbox/ul/ol会被从普通样式字符串中提取出来组合成对应的DecorationStyle变体none/plain则表示无装饰。注意在普通行样式中ul是文字属性下划线只有出现在装饰样式字符串中时才表示下划线装饰两者的歧义正是由 src/parse_style.rs 中的is_decoration_style_string标志消解的。各装饰选项的默认值来自 manual/src/full---help-output.md选项默认值file-decoration-styleblue ulhunk-header-decoration-styleblue boxcommit-decoration-style无装饰merge-conflict-*-decoration-stylebox例如给 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 中与样式直接相关的选项及其默认值汇总选项作用默认值--minus-style删除行normal auto--plus-style新增行syntax auto--zero-style未改动行syntax normal--minus-emph-style/--plus-emph-style删除/新增行中被强调的片段行内 diff 高亮部分normal auto/syntax auto--minus-non-emph-style/--plus-non-emph-style含强调片段的行中非强调部分默认跟随 minus/plus-style--minus-empty-line-marker-style/--plus-empty-line-marker-style空行增删标记仅当对应 style 无背景色时生效normal auto--file-style文件节blue--commit-stylecommit 哈希行raw--hunk-header-stylehunk 头可含file、line-number特殊属性line-number syntax--hunk-header-file-style/--hunk-header-line-number-stylehunk 头中的文件路径 / 行号部分blue--line-numbers-left/right/minus/plus/zero-style行号各列样式auto--grep-file-style/--grep-line-number-stylegrep 输出的文件名 / 行号magenta/green--grep-match-line-style/--grep-match-word-stylegrep 匹配行 / 匹配词默认跟随 plus-style--grep-context-line-stylegrep 非匹配上下文行默认跟随 zero-style--inline-hint-style行内提示如 tab 特殊字符、折行符号blue--whitespace-error-style空白错误git 的color.diff.whitespace否则magenta reverse--blame-code-styleblame 代码段跟随 blame 背景色注意默认值中蕴含的设计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-stylesbold purple red #eeeeee, bold cyan syntax #eeeeee配合git show --coloralways | delta --parse-ansi可把输入中的 ANSI 转义序列以人类可读形式打印出来帮助你识别需要映射的输入样式串。六、实验与调色工具show-config / show-colors / show-themes / show-syntax-themes调试配色不必反复改配置再看 diffdelta 提供了四个实验命令delta --show-config显示所有 delta 选项的当前生效值其中样式字符串选项会同时以前景/背景色渲染出来。可以叠加其他选项做实时实验例如delta --show-config --minus-style red bold ul #ffeeee --darkdelta --show-colors列出所有可用的命名颜色方便挑选 CSS 名 / ANSI 名 / 编号。delta --show-syntax-themes用一段示例 diff 展示所有语法高亮主题。可喂入你自己的 diff 预览效果git show | delta --show-syntax-themes。语法主题由--syntax-theme指定默认取BAT_THEME环境变量--syntax-themenone关闭语法高亮。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_configsrc/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 -cgit -c delta.line-numbersfalse show来自 manual/src/configuration.md。若只想做颜色叠加、不做结构改动用interactive.diffFilter delta --color-only让 delta 作为纯着色器服务其他工具。将配置从 git config 中拆出独立管理可用GIT_CONFIG_GLOBAL环境变量指向独立的 delta 配置文件manual/src/configuration.md。八、常见取舍速查需求推荐写法原因跟随终端主题自动变色ANSI 颜色名red/brightblue…名字对应终端设置的色值换主题自动适应精确固定某色RGB 十六进制#ffeeee不随终端主题变化终端只支持 256 色ANSI 编号如52、28不会因真彩色降级而变色保留输入自带颜色样式值raw让 git--color-moved等原有颜色原样透传文字做语法高亮前景用syntax按文件语言着色只能用在前景位置跟随 delta 默认auto沿用暗/亮模式下的默认色隐藏某元素omitcommit/file/hunk-header-style整体移除该元素强调行内增删词配置*-emph-style配合行内 diff 算法生效更多细节与完整参数表可直接查阅 manual/src/full---help-output.md 的STYLES、COLORS与各选项条目如果想了解如何把这些样式组织成可复用的命名分组参见 manual/src/features-named-groups-of-settings.md。赞分享开发工具CLI【免费下载链接】deltaA syntax-highlighting pager for git, diff, grep, rg --json, and blame output项目地址https://gitcode.com/gh_mirrors/de/delta点击查看免费下载相关推荐python-prompt-toolkit 样式系统完全指南Style 字符串、样式表与颜色深度python prompt toolkit 样式系统完全指南Style 字符串、样式表与颜色深度 本指南基于 docs/pages/advanced_topiCLIFunASR INT8量化语音识别模型压到800MB精度损失不到0.5%FunASR INT8量化语音识别模型压到800MB精度损失不到0.5% 一句话先说结论用 FunASR 的 INT8 量化把 Paraformer 级语音音频人工智能大模型模型推理服务本地部署LikeC4 DSL 样式令牌与颜色体系从语义色板到图标的完整配色指南LikeC4 DSL 样式令牌与颜色体系从语义色板到图标的完整配色指南 LikeC4 是面向软件架构的架构即代码Architecture as Code工开发工具数据可视化CLI前端MCP 服务上一篇下载速度常年几十KB给BT客户端加满这份每天更新的Tracker清单5分钟改头换面下一篇Kubescape时间窗口设置调度Kubernetes定期安全扫描创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考