Tarquin note

Fastfetch 使用说明文档

2024.06.0318 min read

本文迁移自 wl.do 原文，已按本站 2024 归档规则保留原文结构。

项目简介

Fastfetch 是一个类似 Neofetch 的系统信息展示工具, 主要使用 C 语言编写, 注重性能和可定制性。它能够以美观的方式获取和显示系统信息。

主要特点

积极维护: 与已停止维护的 Neofetch 不同, Fastfetch 持续更新
高性能: 执行速度更快, 响应更迅速
跨平台支持: Linux、macOS、Windows 7+、Android、FreeBSD、OpenBSD、NetBSD、DragonFly、Haiku 和 SunOS
功能丰富: 支持更多模块和配置选项
高度可定制: 使用 JSONC 格式配置文件, 支持 JSON Schema 智能提示
更精确: 支持 Wayland 协议, 数据显示更准确

项目信息

GitHub 仓库: https://github.com/fastfetch-cli/fastfetch
Star 数量: 17.5 k+
许可证: MIT License
主要维护者: CarterLi
原作者: LinusDierheimer

安装指南

Linux

Debian/Ubuntu

# Debian 13 及更高版本
apt install fastfetch


# Debian 11+ / Ubuntu 20.04+ - 下载 deb 包安装
wget https://github.com/fastfetch-cli/fastfetch/releases/download/VERSION/fastfetch-linux-<架构>.deb
sudo dpkg -i fastfetch-linux-<架构>.deb
Bash

Arch Linux

pacman -S fastfetch
Bash

Fedora

dnf install fastfetch
Bash

Gentoo

emerge --ask app-misc/fastfetch
Bash

Alpine

apk add --upgrade fastfetch
Bash

NixOS

nix-shell -p fastfetch
Bash

OpenSUSE

zypper install fastfetch
Bash

Void Linux

xbps-install fastfetch
Bash

使用 Linuxbrew

如果你的发行版没有打包或版本过旧:

brew install fastfetch
Bash

MacOS

Homebrew

brew install fastfetch
Bash

MacPorts

sudo port install fastfetch
Bash

Windows

Scoop

scoop install fastfetch
Bash

Chocolatey

choco install fastfetch
Bash

Winget

winget install fastfetch
Bash

MSYS 2 MinGW

pacman -S mingw-w64-<子系统>-<架构>-fastfetch
Bash

BSD 系统

FreeBSD

pkg install fastfetch
Bash

NetBSD

pkgin in fastfetch
Bash

OpenBSD

pkg_add fastfetch
Bash

DragonFly BSD

pkg install fastfetch
Bash

Android (Termux)

pkg install fastfetch
Bash

快速开始

基本运行

安装完成后, 直接运行:

fastfetch
Bash

这将使用默认配置显示系统信息和 ASCII Logo。

查看帮助

# 查看所有选项
fastfetch --help


# 查看特定选项的帮助
fastfetch -h <选项名>


# 查看模块格式帮助
fastfetch -h <模块名>-format
Bash

查看可用资源

# 列出所有可用模块
fastfetch --list-modules


# 列出所有可用 Logo
fastfetch --list-logos


# 列出所有预设配置
fastfetch --list-presets


# 列出配置文件搜索路径
fastfetch --list-config-paths


# 列出数据文件搜索路径
fastfetch --list-data-paths


# 列出编译支持的特性
fastfetch --list-features
Bash

运行所有模块

fastfetch -c all.jsonc
Bash

这将显示所有支持的模块, 帮助你了解可用功能。

配置文件

配置文件位置

默认配置文件路径:

~/.config/fastfetch/config.jsonc

配置文件搜索顺序:

当前工作目录
~/.local/share/fastfetch/presets/
/usr/share/fastfetch/presets/

生成配置文件

# 生成最小配置文件
fastfetch --gen-config


# 生成完整配置文件(包含所有可选项)
fastfetch --gen-config-full


# 生成到指定路径
fastfetch --gen-config /path/to/config.jsonc


# 强制覆盖现有配置
fastfetch --gen-config-force


# 输出到标准输出
fastfetch --gen-config -
Bash

配置文件结构

Fastfetch 使用JSONC(JSON with Comments) 格式, 支持注释。

基本结构:

{
    "$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json",
    "logo": {
        // Logo 配置
    },
    "display": {
        // 显示设置
    },
    "modules": [
        // 模块列表
    ]
}

JSON Schema 支持

在配置文件开头添加$schema字段可以在支持的编辑器 (如 VS Code、Helix) 中获得智能提示和语法检查:

{
    "$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json"
}
JSON

常用命令

指定配置文件

# 使用自定义配置文件
fastfetch -c /path/to/config.jsonc


# 使用预设配置
fastfetch -c neofetch
fastfetch -c hardware
fastfetch -c paleofetch


# 禁用配置加载
fastfetch -c none
Bash

自定义结构

使用-s或--structure指定要显示的模块 (用冒号分隔):

fastfetch -s title:separator:os:kernel:uptime:memory


# 只显示操作系统信息
fastfetch -s os


# 显示多个模块
fastfetch -s OS:Kernel:Packages:Terminal:Memory:Locale
Bash

自定义 Logo

# 使用内置 Logo
fastfetch --logo arch


# 禁用 Logo
fastfetch --logo none
fastfetch -l none


# 使用自定义图片
fastfetch -l /path/to/logo.png


# 使用 ASCII 艺术文件
fastfetch --logo /path/to/ascii-art.txt
Bash

修改 Logo 颜色

# 修改 Logo 颜色
fastfetch --logo-color-1 red --logo-color-2 green


# 使用小型 Logo
fastfetch --logo-type small
Bash

输出格式

# JSON 格式输出
fastfetch --format json
fastfetch -j


# 查看特定模块的 JSON 数据
fastfetch -s os:kernel --format json
Bash

性能统计

# 显示每个模块的执行时间
fastfetch --stat
Bash

保存配置

将当前命令行选项保存为配置文件:

fastfetch -s os:kernel:memory --logo arch --gen-config
Bash

模块配置

可用模块类型

常用模块包括:

系统信息

title - 用户名@主机名
separator - 分隔线
os - 操作系统
kernel - 内核版本
uptime - 系统运行时间
packages - 已安装软件包

硬件信息

host - 主机型号
cpu - CPU 信息
gpu - GPU 信息
memory - 内存使用
disk - 磁盘使用
battery - 电池状态
display - 显示器信息

软件信息

shell - Shell 类型
terminal - 终端类型
de - 桌面环境
wm - 窗口管理器
theme - 主题
icons - 图标主题
font - 字体

网络信息

localip - 本地 IP 地址
publicip - 公网 IP 地址

其他

colors - 终端颜色展示
custom - 自定义文本
command - 执行命令输出

模块配置方式

简单配置

使用字符串形式启用默认配置:

{
    "modules": [
        "title",
        "separator",
        "os",
        "kernel",
        "uptime"
    ]
}

高级配置

使用对象形式自定义模块:

{
    "modules": [
        {
            "type": "os",
            "key": "操作系统",
            "keyColor": "blue",
            "format": "{name} {version}"
        },
        {
            "type": "cpu",
            "key": " CPU",
            "format": "{name} ({cores}核)"
        },
        {
            "type": "memory",
            "key": " 内存",
            "format": "{used} / {total} ({percentage}%)"
        }
    ]
}

模块格式化

每个模块支持自定义格式字符串:

{
    "type": "cpu",
    "format": "{name} ({cores-physical}C/{cores-logical}T) @ {freq-max}"
}

查看模块支持的格式占位符:

fastfetch -h cpu-format
fastfetch -h memory-format
fastfetch -h disk-format
Bash

自定义文本模块

添加自定义文本或分隔线:

{
    "type": "custom",
    "format": "┌─────────── 硬件信息 ───────────┐"
}

Command 模块

执行命令并显示输出:

{
    "type": "command",
    "key": "编辑器",
    "text": "$EDITOR --version | head -1"
}

⚠️警告: Command 模块可以执行任意 Shell 命令, 请勿使用来自不可信来源的配置文件。

Logo 自定义

Logo 配置结构

{
    "logo": {
        "type": "auto",           // Logo 类型
        "source": "arch",         // Logo 源
        "width": 65,              // 宽度(字符)
        "height": 35,             // 高度(字符)
        "padding": {
            "top": 0,
            "left": 0,
            "right": 2
        },
        "color": {
            "1": "blue",
            "2": "cyan"
        }
    }
}

Logo 类型

auto - 自动检测
builtin - 内置 ASCII Logo
small - 小型 Logo
file - 文件 Logo
data - 原始数据
none - 不显示 Logo
iterm - iTerm 图片协议
kitty - Kitty 图片协议
sixel - Sixel 图片协议
chafa - Chafa 图片渲染

使用内置 Logo

# 命令行方式
fastfetch --logo arch


# 配置文件方式
{
    "logo": {
        "type": "builtin",
        "source": "arch"
    }
}
Bash

使用自定义 ASCII 艺术

创建一个文本文件custom-logo.txt, 使用颜色占位符$1到$9:

$1  ████████
$1  ██$2╔════╝
$1  ██$2║
$1  ██$2║
$1  ╚═╝

然后在配置中引用:

{
    "logo": {
        "type": "file",
        "source": "~/.config/fastfetch/custom-logo.txt",
        "color": {
            "1": "blue",
            "2": "yellow"
        }
    }
}

或命令行:

fastfetch -l ~/custom-logo.txt --logo-color-1 blue --logo-color-2 yellow
Bash

使用图片 Logo

Linux/macOS

# 自动选择协议
fastfetch -l ~/Pictures/logo.png


# 指定宽度
fastfetch -l ~/Pictures/logo.png --logo-width 30
Bash

Windows

Mintty / Wezterm:

{
    "logo": {
        "type": "iterm",
        "source": "C:/path/to/image.png",
        "width": 30
    }
}

Windows Terminal(需要 Sixel 支持):

{
    "logo": {
        "type": "sixel",
        "source": "C:/path/to/image.png",
        "width": 30,
        "height": 20
    }
}

Logo 颜色配置

颜色占位符$1到$9对应 9 种颜色:

{
    "logo": {
        "color": {
            "1": "red",
            "2": "green",
            "3": "yellow",
            "4": "blue",
            "5": "magenta",
            "6": "cyan",
            "7": "white",
            "8": "bright-red",
            "9": "bright-green"
        }
    }
}

支持的颜色名称:

基础色: black , red , green , yellow , blue , magenta , cyan , white
亮色: 在颜色名前加 bright- 或 light- , 如 bright-red , light-blue

格式字符串

基本语法

格式字符串包含占位符\{name\}或\{index\}:

"值: {1} ({2})"

使用值 "First" 和 "Second" 会产生:值: First (Second)

命名标签

使用有意义的名称代替数字:

fastfetch --title-format '{user-name}@{host-name}'
Bash

查看支持的标签:

fastfetch -h title-format
Bash

字符串操作

截断

# 截断为 5 个字符
{user-name:5}


# 截断并添加省略号
{user-name:-5}
Bash

填充

# 左对齐,填充到 20 个字符
{user-name<20}


# 右对齐,填充到 20 个字符
{user-name>20}
Bash

切片

# 前 5 个字符
{~0,5}


# 后 5 个字符
{~-5,}


# 从第 3 个到倒数第 2 个
{~2,-2}
Bash

变量引用

环境变量

{$HOME}        # 环境变量
{$NUM}         # 常量(需在 display.constants 中定义)
Bash

自动索引

空占位符自动使用递增索引:

"值: {} ({})"  # 等同于 "值: {1} ({2})"
Bash

条件内容

值存在时显示

{?2} 第二个值: {2}{?}
Bash

仅当第 2 个值存在时才显示。

值不存在时显示

{/2}值不可用{/}
Bash

仅当第 2 个值不存在时才显示。

组合使用

{?2}{2}{?}{/2}备用值{/}
Bash

如果第 2 个值存在则显示它, 否则显示 "备用值"。

颜色格式化

使用\{#\}添加颜色:

# ANSI 颜色代码
{#4;35}彩色文本{#}


# 命名颜色
{#underline_magenta}彩色文本{#}


# 重置颜色
{#0} 或 {#}
Bash

查看支持的颜色:

fastfetch -h color
Bash

特殊字符

{{ - 显示单个 {
{-} - 终止格式化

示例

{
    "type": "cpu",
    "format": "{#blue}{name}{#} ({cores}核) @ {freq-max} GHz"
},
{
    "type": "memory",
    "format": "{used:8} / {total:8} ({percentage}%)"
},
{
    "type": "disk",
    "format": "{?1}{1}: {/}{2} / {3} ({4}%)"
}

预设配置

查看预设

fastfetch --list-presets
Bash

使用预设

# Neofetch 风格
fastfetch -c neofetch


# 硬件信息
fastfetch -c hardware


# 软件信息
fastfetch -c software


# 极简风格
fastfetch -c paleofetch


# 所有模块
fastfetch -c all
Bash

常用预设

预设名称	说明
neofetch.jsonc	模仿 Neofetch 风格
paleofetch.jsonc	极简风格
hardware.jsonc	专注硬件信息
software.jsonc	专注软件信息
ci.jsonc	适合 CI 环境
all.jsonc	显示所有模块

自定义预设目录

将自定义预设保存到:

~/.local/share/fastfetch/presets/

然后使用:

fastfetch -c my-preset
Bash

常见问题

Q: 为什么选择 Fastfetch 而不是 Neofetch?

Fastfetch 正在积极维护, Neofetch 已停止更新
Fastfetch 性能更快
支持更多功能和模块
配置更灵活
数据显示更精确 (如单位统一)
原生支持 Wayland 协议

Q: 配置文件在哪里?

A: 默认位置是~/.config/fastfetch/config.jsonc。Fastfetch 不会自动生成配置文件, 需要手动生成:

fastfetch --gen-config
Bash

Q: Fastfetch 显示本地 IP 地址, 会泄露隐私吗?

A: 不会。本地 IP 地址 (10.x.x.x, 172.x.x.x, 192.168.x.x) 只在局域网内有意义, 不涉及隐私问题。如果不想显示, 可以在配置文件中禁用localip模块。

Q: 如何隐藏某个模块的键名?

A: 将键设置为空格:

{
    "type": "os",
    "key": " "
}

Q: 如何自定义模块输出?

A: 使用format字段:

{
    "type": "gpu",
    "format": "{name}"  // 只显示 GPU 名称
}

查看模块支持的格式:

fastfetch -h gpu-format
Bash

Q: 为什么 Logo 颜色显示不正确?

A: 确保你的终端支持 256 色或 True Color。可以尝试:

fastfetch --pipe false
Bash

强制启用彩色模式。

Q: Fastfetch 与 p 10 k 冲突, 启动时显示黑白?

A: 将fastfetch命令放在p10k-instant-prompt初始化之前, 或使用:

fastfetch --pipe false
Bash

Q: 在 Windows 中如何显示图片?

Mintty/Wezterm: 支持 iTerm 协议
Windows Terminal: 需要使用 Sixel 格式, 参见 Logo 自定义章节

Q: GPU 显示为 "XXXX Device XXXX (VGA compatible)"?

A: 在 Debian/Ubuntu 系统上, 需要更新 PCI ID 数据库:

# 下载并更新 pci.ids
sudo wget https://pci-ids.ucw.cz/v2.2/pci.ids -O /usr/share/hwdata/pci.ids


# AMD GPU 还需要更新 amdgpu.ids
sudo wget https://gitlab.freedesktop.org/mesa/drm/-/raw/main/data/amdgpu.ids -O /usr/share/libdrm/amdgpu.ids
Bash

或使用驱动专用检测:

fastfetch --gpu-driver-specific
Bash

Q: Root 身份运行时出现 "Authorization required" 错误?

A: 设置 XAUTHORITY 环境变量:

export XAUTHORITY=$HOME/.Xauthority
Bash

Q: 如何让 Fastfetch 在终端启动时自动运行?

A: 在 Shell 配置文件中添加:

Bash(~/.bashrc):

fastfetch
Bash

Zsh(~/.zshrc):

fastfetch
Bash

Fish(~/.config/fish/config.fish):

fastfetch

如果遇到问题, 可以添加延迟:

sleep 0.2 && fastfetch
Bash

高级技巧

显示配置

全局显示设置:

{
    "display": {
        "separator": " → ",
        "color": {
            "keys": "blue",
            "title": "cyan"
        },
        "key": {
            "width": 12,
            "type": "both"  // string, icon, both, none
        },
        "bar": {
            "width": 15,
            "char": {
                "elapsed": "█",
                "total": "░"
            },
            "border": true
        },
        "percent": {
            "type": 9,  // 1=数字, 2=条形, 3=两者, 9=彩色数字
            "color": {
                "green": "green",
                "yellow": "yellow",
                "red": "red"
            }
        }
    }
}

温度颜色配置

{
    "display": {
        "temp": {
            "green": 60,
            "yellow": 80
        }
    }
}

< 60°C: 绿色
60-80°C: 黄色
80°C: 红色

磁盘模块高级配置

{
    "type": "disk",
    "key": " 磁盘",
    "folders": "/:/home:/boot",
    "format": "{1}: {2} / {3} ({4}%)"
}

电池温度检测

fastfetch --battery-temp
Bash

GPU 详细信息

# 使用驱动专用方法
fastfetch --gpu-driver-specific


# 指定检测方法
fastfetch --gpu-detection-method auto
Bash

动态更新

保持 Fastfetch 运行并定时更新:

fastfetch --dynamic-interval 1000  # 每秒更新
Bash

使用自定义常量

在配置文件中定义常量:

{
    "display": {
        "constants": {
            "MY_TEXT": "自定义文本"
        }
    },
    "modules": [
        {
            "type": "custom",
            "format": "{$MY_TEXT}"
        }
    ]
}

多模块组合与分组

{
    "modules": [
        {
            "type": "custom",
            "format": "┌─────────── 硬件信息 ───────────┐"
        },
        "host",
        "cpu",
        "gpu",
        "memory",
        {
            "type": "custom",
            "format": "├─────────── 软件信息 ───────────┤"
        },
        "os",
        "kernel",
        "shell",
        "packages",
        {
            "type": "custom",
            "format": "└────────────────────────────────┘"
        }
    ]
}

使用 FIGlet 生成文本 Logo

# 安装 pyfiglet 和 jq
pyfiglet -s -f small_slant $(fastfetch -s os --format json | jq -r '.[0].result.name') && fastfetch -l none
Bash

配置文件示例

完整配置示例:

{
    "$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json",
    "logo": {
        "type": "auto",
        "source": "arch",
        "padding": {
            "right": 2
        },
        "color": {
            "1": "blue",
            "2": "bright-blue"
        }
    },
    "display": {
        "separator": ": ",
        "color": {
            "keys": "blue",
            "title": "cyan"
        },
        "key": {
            "width": 12
        },
        "bar": {
            "width": 15,
            "char": {
                "elapsed": "■",
                "total": "-"
            }
        }
    },
    "modules": [
        "title",
        "separator",
        {
            "type": "os",
            "key": "OS",
            "format": "{name} {version}"
        },
        {
            "type": "kernel",
            "key": "Kernel"
        },
        {
            "type": "uptime",
            "key": "Uptime"
        },
        {
            "type": "packages",
            "key": "Packages"
        },
        {
            "type": "shell",
            "key": "Shell"
        },
        {
            "type": "terminal",
            "key": "Terminal"
        },
        {
            "type": "cpu",
            "key": "CPU",
            "format": "{name} ({cores}核)"
        },
        {
            "type": "gpu",
            "key": "GPU"
        },
        {
            "type": "memory",
            "key": "Memory",
            "format": "{used} / {total} ({percentage}%)"
        },
        {
            "type": "disk",
            "key": "Disk",
            "folders": "/",
            "format": "{used} / {total} ({percentage}%)"
        },
        "separator",
        "colors"
    ]
}

#wl-do #fastfetch