bat — 更好的 cat

支持语法高亮、行号显示和 Git 集成的 cat。

快速入门

基本用法

# 使用语法高亮查看文件
bat README.md

# 查看多个文件
bat file1.js file2.py

# 显示行号（默认行为）
bat script.sh

# 不显示行号
bat -p script.sh

查看模式

# 纯文本模式（类似 cat）
bat -p file.txt

# 显示不可见字符（如空格、制表符等）
bat -A file.txt

# 合并连续空行
bat -s file.txt

# 分页显示（大文件自动启用）
bat --paging=always file.txt
bat --paging=never file.txt

语法高亮

语言检测

# 根据文件扩展名自动识别语言
bat script.py

# 强制指定语言
bat -l javascript config.txt

# 列出所有支持的语言
bat --list-languages

主题

# 列出可用主题
bat --list-themes

# 使用指定主题
bat --theme="Monokai Extended" file.py

# 在配置文件中设置默认主题
# ~/.config/bat/config: --theme="Dracula"

行范围控制

# 仅显示指定行范围
bat -r 10:20 file.txt

# 从第 100 行到文件末尾
bat -r 100: file.txt

# 从开头到第 50 行
bat -r :50 file.txt

# 多个行范围（可重复使用 -r）
bat -r 1:10 -r 50:60 file.txt

Git 集成

# 显示 Git 差异（新增/删除/修改的行）
bat --diff file.txt

# 显示装饰信息（Git 状态 + 文件头）
bat --decorations=always file.txt

输出控制

# 输出原始内容（禁用所有样式）
bat --style=plain file.txt

# 自定义输出样式
bat --style=numbers,changes file.txt

# 可用样式选项：auto、full、plain、changes、header、grid、numbers、snip
bat --style=header,grid,numbers file.txt

常见使用场景

快速预览文件：

bat file.json

带语法高亮查看日志：

bat error.log

可视化对比文件差异：

bat --diff file1.txt
bat file2.txt

编辑前预览：

bat config.yaml && vim config.yaml

在管道中替代 cat：

bat -p file.txt | grep "pattern"

查看特定函数（假设其位于 45–67 行）：

bat -r 45:67 script.py

与其他工具集成

作为 man 页面的分页器：

export MANPAGER="sh -c 'col -bx | bat -l man -p'"
man grep

与 ripgrep 配合使用：

rg "pattern" -l | xargs bat

与 fzf 配合使用（预览）：

fzf --preview 'bat --color=always --style=numbers {}'

与 diff 配合使用：

diff -u file1 file2 | bat -l diff

配置

创建 ~/.config/bat/config 文件以设置默认选项：

# 设置主题
--theme="Dracula"

# 显示行号、Git 修改标记和文件头，但不显示网格线
--style="numbers,changes,header"

# 在终端中启用斜体文本
--italic-text=always

# 添加自定义语法映射
--map-syntax "*.conf:INI"

性能优化建议

• 在管道中使用时，推荐加 -p 启用纯文本模式
• 当输出被其他程序解析时，使用 --paging=never
• bat 会对已解析的文件进行缓存，加快后续访问速度

实用技巧

• 别名设置： alias cat='bat -p'，实现无缝替换 cat
• 设为默认分页器： 使用 export PAGER="bat"
• Debian/Ubuntu 注意： 命令名可能为 batcat 而非 bat
• 自定义语法支持： 将语法定义添加至 ~/.config/bat/syntaxes/
• 处理超大文件： 推荐使用 bat --paging=never 或直接使用原生 cat

常用命令行参数

• -p / --plain：纯文本模式（禁用行号与装饰）
• -n / --number：仅显示行号
• -A / --show-all：显示不可见字符
• -l / --language：手动指定语法高亮语言
• -r / --line-range：限定显示的行范围

文档

GitHub 仓库：https://github.com/sharkdp/bat
Man 手册页：man bat
自定义配置指南：https://github.com/sharkdp/bat#customization