Fastfetch 使用说明文档

系统信息展示不是炫技，是让别人快速理解你的运行环境。

Fastfetch 是我现在更愿意放进终端启动页里的系统信息工具。它比老工具更快，也更适合在不同机器之间复用配置，但真正值得写进笔记的不是“它能显示 logo”，而是它能稳定输出一份环境快照。

我把 Fastfetch 当成 开发环境名片：系统版本、Shell、终端、CPU、内存、包管理器都能一次看清楚。

先跑默认输出

不要一上来就调配置。先看默认输出能不能满足你定位环境问题的需要，再决定要不要改模块。

fastfetch
fastfetch --version

如果只是给别人看机器概况，默认配置通常已经够用。真正需要定制的场景，往往是自动化脚本或截图展示。

我会保留的字段

• 操作系统版本，方便确认系统兼容性。
• Kernel 和 Shell，排查脚本差异时很有用。
• CPU、GPU、内存，适合做性能问题背景。
• 包管理器数量，能快速看出环境复杂度。

再考虑配置文件

Fastfetch 支持 JSONC 配置。我的建议是只改你确实要看的模块，别为了截图好看把配置写成一篇小说。

一个极简配置可以像这样：

{
  "$schema": "https://github.com/fastfetch-cli/fastfetch/raw/dev/doc/json_schema.json",
  "modules": ["title", "os", "kernel", "shell", "terminal", "cpu", "memory"]
}

这份配置只保留排查环境最常用的信息。modules 越少，输出越稳定，也越适合贴进 issue 或团队文档。

自动化里怎么用

Fastfetch 可以作为诊断脚本的第一步。比如我会在 bug 复现记录里加一段环境输出，然后再写复现命令。

1. 先运行 fastfetch --version 确认工具版本。
2. 再运行定制配置输出核心环境。
3. 最后贴上项目命令和报错日志。

保持输出克制

如果一份系统信息超过半屏，大概率就过量了。环境快照应该帮助读者理解问题，而不是把读者淹死在硬件细节里。工具是工具，别让它抢正文的戏。

输出裁剪表

• 默认输出先跑一次。
• 用 Ctrl + C 快速中断过长输出。
• 给公开截图准备一份 最小配置。