企业官网建设流程全解析

• 开发工具
• CLI

本文以 delta 官方手册的 行号（Line numbers）章节 为主线，完整讲解 delta 的行号显示机制：如何通过一行配置开启、两列行号各代表什么、七个行号相关选项的含义与默认值、格式字符串与占位符语法、以及如何借助"特性（features）"机制把低调美观的行号样式固化到 git 配置中。读完本文，你将能像配置git diff高亮一样，熟练地为 delta 输出定制出符合个人审美的行号列。

快速启用：一行配置

在 delta 的所有显示增强中，行号是最直观也最常用的一项。在 git 配置中加入：

[delta] line-numbers = true

即可为 diff 的每一行左侧渲染出行号。除配置文件外，命令行也提供了等价开关：-n与--line-numbers，例如git -c delta.line-numbers=true diff或在 delta 直接处理 diff 输入时使用delta -n。该选项在 src/cli.rs 中定义，并在 src/config.rs 中写入运行期配置；从源码看，当--word-diff（逐词 diff）生效时行号会被自动关闭（opt.line_numbers && !handlers::hunk::is_word_diff()），以免干扰词级高亮。

开启后，行号会以左右两列的形式出现在 diff 行首，且全部行为都可定制——完整选项清单见delta --help输出的LINE NUMBERS小节（manual/src/full---help-output.md）。

两列行号：各列表示什么

默认配置下，delta 的行号输出长这样：

1 ⋮ 1 │ unchanged line 2 ⋮ │ removed line ⋮ 2 │ added line

• 左列：旧版本（minus 文件）中的行号；
• 右列：新版本（plus 文件）中的行号；
• 在**未改动行（zero 行）**上，两列都会显示行号；在删除行上只有左列有数字，在新增行上只有右列有数字；
• 默认以⋮（左列之后）和│（右列之后）作为分隔字符。

这套两列结构由 src/features/line_numbers.rs 中的linenumbers_and_styles驱动：delta 在遍历 diff 内容时维护HunkMinus、HunkPlus、HunkZero三种行状态，分别递增左侧、右侧或双侧行号计数；遇到折行（HunkMinusWrapped、HunkPlusWrapped、HunkZeroWrapped）时则输出空行号，保证后续真实行号不错位。该模块内还有多组测试（如test_one_minus_one_plus_line、test_line_numbers_continue_correctly）验证了行号续接逻辑。

七个行号定制选项一览

行号显示由以下 7 个选项控制，全部既可作为[delta]下的 git 配置键，也可作为 CLI 参数（在 src/cli.rs 中定义）：

其中四个*-style选项的"特性层默认值"可以在 src/features/line_numbers.rs 的内置特性定义中看到：它们会根据终端是亮色还是暗色背景（--light/--dark，即 color mode）自动选择默认颜色，因此 CLI 层的auto实际解析结果取决于主题。样式字符串的解析逻辑集中在 src/parse_styles.rs 的make_line_number_styles中，与 delta 其他样式的解析共用同一套规则（支持颜色名、RGB 十六进制、ANSI 颜色名与 ANSI 数字等四种颜色写法，详见delta --help的Colors小节）。

格式字符串：{nm}与{np}占位符

--line-numbers-left-format与--line-numbers-right-format接受任意格式字符串，其中允许使用两个占位符：

• {nm}：旧版本（minus 文件）的行号；
• {np}：新版本（plus 文件）的行号。

占位符支持 Rust 格式化语法的一个子集，重点是宽度与对齐语法：<表示左对齐、^表示居中、>表示右对齐，后面可跟数字宽度，例如{nm:>4}表示右对齐、宽度 4。以默认值拆解为例：

• {nm:^4}⋮：左列居中显示 minus 行号、补齐到 4 字符宽，后跟分隔符⋮；
• {np:^4}│：右列居中显示 plus 行号、补齐到 4 字符宽，后跟分隔符│。

占位符的底层解析见 src/format.rs 与parse_line_number_format：delta 用正则把格式字符串拆成"前缀 + 占位符 + 后缀"的片段序列，一个格式串里可以出现多个占位符（源码注释里就举了line-numbers-right-format = "{nm} {np}|"的例子），同一个占位符也可以重复使用。行号渲染时实际列宽不是固定 4，而是根据当前 hunk 内最大行号的位数自动扩展（见 src/features/line_numbers.rs 的hunk_max_line_number_width），所以万行级文件的行号也能对齐，相关行为有test_five_digit_line_number、test_unequal_digit_line_number等测试覆盖。

样式字符串：给行号上色

四个*-style选项的值都是标准 delta 样式字符串，可以组合前景色、背景色与粗体等属性。比如：

[delta] line-numbers-minus-style = "#444444" # 删除行行号用深灰 line-numbers-zero-style = "#444444" # 未改动行行号用深灰 line-numbers-plus-style = "#444444" # 新增行行号用深灰 line-numbers-left-style = blue # 左列（含分隔符）整体用蓝色 line-numbers-right-style = blue # 右列（含分隔符）整体用蓝色

注意*-left-style/*-right-style作用于整列（包括分隔符与占位符前后的静态字符），而*-minus-style/*-zero-style/*-plus-style只作用于行号数字本身。风格上若追求低调，可用"#444444"这类暗灰色；若希望行号与 diff 内容呼应，可保持默认（暗色主题下删除行88、新增行28、未改动行#444444）。颜色写法与默认色板的权威说明仍以delta --help的Colors、Styles小节为准。

实战案例：用"特性（features）"组织低调行号样式

delta 的所有选项都可以平铺写在[delta]段下，但官方推荐用**命名特性（named features）**来组织，即[delta "my-feature"]这样的配置段，再通过[delta]段的features键按顺序启用。手册的 features-named-groups-of-settings.md 给出了一个把"低调行号"与"装饰风格"组合起来的完整示例：

[delta] features = unobtrusive-line-numbers decorations whitespace-error-style = 22 reverse [delta "unobtrusive-line-numbers"] line-numbers = true line-numbers-minus-style = "#444444" line-numbers-zero-style = "#444444" line-numbers-plus-style = "#444444" line-numbers-left-format = "{nm:>4}┊" line-numbers-right-format = "{np:>4}│" line-numbers-left-style = blue line-numbers-right-style = blue [delta "decorations"] commit-decoration-style = bold yellow box ul file-style = bold yellow ul file-decoration-style = none hunk-header-decoration-style = yellow box

这段配置把行号固化为"右对齐、┊/│分隔、数字统一深灰、列整体蓝色"的观感，并把 commit 头、文件名、hunk 头的装饰一并定制。由于特性按features中列出的顺序合并，后启用的decorations不会覆盖先启用的行号设置——这正是特性机制的价值：把互不干扰的关注点拆成可独立启用的单元。

特性还可以在命令行临时启停。环境变量DELTA_FEATURES接受空格分隔的特性名列表，且支持+前缀表示追加而不是替换已有特性：

# 临时切换为 side-by-side 模式（追加，而非覆盖现有特性） export DELTA_FEATURES=+side-by-side # 撤销：清空追加内容，恢复原有配置 export DELTA_FEATURES=+

与 side-by-side 模式的配合

开启--side-by-side后，行号仍然有效，但两列不再同时出现：左面板只渲染旧版本行号、右面板只渲染新版本行号，且默认格式会被替换为│{nm:^4}│与│{np:^4}│（见 src/features/side_by_side.rs）。渲染端在 src/features/line_numbers.rs 的format_and_paint_line_numbers中按面板选择只输出对应一侧；当列宽为奇数、需要居中对齐时，delta 还会用专门的填充字符补齐（ODD_PAD_CHAR），测试test_line_numbers_continue_correctly_after_wrapping验证了折行与行号续接在并排视图下依然正确。

更多细节与延伸阅读

• 行号右列在启用--hyperlinks且能确定目标文件时，会把行号渲染为指向该文件对应行的终端超链接（见 src/features/line_numbers.rs 的format_line_number）；
• 行号列宽随 hunk 内最大行号位数自动伸缩，无需手动适配大文件；
• 全部选项的权威说明与示例位于 delta --help 完整输出 的LINE NUMBERS小节；
• 特性机制与DELTA_FEATURES的完整说明见 "Features": 命名设置组。

结合 src/features/line_numbers.rs 及其内嵌测试，你可以把行号功能理解为一个完整的"渲染管线"：hunk 状态机维护行号计数 → 格式字符串解析占位符 → 样式解析上色 → 按面板/宽度/对齐规则输出。理解了这条管线，任何行号定制需求（对齐方式、分隔符、颜色、超链接）都能在配置层直接实现，无需改动 delta 本身。

• 开发工具
• CLI