findmnt 怎么输出适合脚本读取的 JSON

如果脚本要读取 Linux 的挂载信息，不要解析 findmnt 默认的树形表格。更稳的做法是显式加上 --json，再用 --output 固定字段；只有确实需要父子挂载关系时，才增加 --tree。这样脚本依赖的是 JSON 字段，而不是终端缩进、列宽或默认输出顺序。

先用 --json 和 --output 固定字段

findmnt 可以查询挂载表、/etc/fstab 或内核挂载信息。手册特别提醒，默认输出格式可能变化，脚本应显式指定预期列。下面的命令只保留脚本通常需要的四个字段：

# 显式指定 JSON 和字段，避免依赖默认列宽与树形缩进
findmnt --json \
  --output=TARGET,SOURCE,FSTYPE,OPTIONS

结果的顶层通常是一个包含 filesystems 数组的 JSON 对象。target 是挂载点，source 是来源，fstype 是文件系统类型，options 是挂载选项。字段名由 findmnt 的 JSON 输出负责转换，脚本不要再把它当成空格分隔的文本。

平面列表和挂载树要分开选择

如果任务只是统计真实文件系统、筛选某个类型或导出一行一条记录，优先让输出保持列表语义；如果任务要解释 overlay、bind mount 或子挂载的父子关系，则保留树形关系：

# 适合批量统计：固定字段并要求列表形式
findmnt --json --list \
  --output=TARGET,SOURCE,FSTYPE,OPTIONS

# 适合分析嵌套挂载：保留父子关系，解析器需要递归 children
findmnt --json --tree \
  --output=TARGET,SOURCE,FSTYPE,OPTIONS

两者不是“哪个更标准”的区别，而是数据模型不同。列表适合直接遍历 filesystems；树形结果可能在节点下出现 children，脚本应递归读取，而不能假设每条记录都在同一层。

用 jq 或 Python 读取字段，不要切列

JSON 的价值在于路径、逗号和转义字符由解析器处理。比如只列出挂载目标和文件系统类型，可以使用 jq：

# 只取 JSON 对象里的两个字段，缺失值用空字符串代替
findmnt --json --list --output=TARGET,FSTYPE \
  | jq -r '.filesystems[] | [(.target // ""), (.fstype // "")] | @tsv'

如果要继续做条件判断，Python 的 json 模块更容易表达“没有 children”和“字段缺失”这两种情况：

import json
import subprocess

# 让 findmnt 只返回脚本需要的字段，避免解析人类可读表格
command = [
    "findmnt", "--json", "--list",
    "--output=TARGET,SOURCE,FSTYPE,OPTIONS",
]
result = subprocess.run(command, text=True, capture_output=True, check=False)

# 退出码非零时保留 stderr，区分查询失败与合法的空结果
if result.returncode != 0:
    raise RuntimeError(result.stderr.strip() or "findmnt 查询失败")

payload = json.loads(result.stdout)
for item in payload.get("filesystems", []):
    # 用 get 处理不同 util-linux 版本或自定义列造成的字段缺失
    print(item.get("target", ""), item.get("fstype", ""))

这里没有把示例输出伪装成某台机器的真实结果。关键是解析路径：先判断命令退出状态，再解析 JSON，最后从明确的数组和字段读取值。

把过滤条件、退出码和版本差异写进契约

脚本稳定性不只取决于 JSON 开关，还取决于查询范围。查询单个路径时，--target 会按路径元素寻找其所在文件系统；如果必须只匹配明确挂载点，可以考虑 --mountpoint，避免把普通路径的父级挂载误当成目标。

# 只查询 /data 所在的文件系统，并保持机器可读输出
findmnt --json --target /data \
  --output=TARGET,SOURCE,FSTYPE,OPTIONS

# 查询没有结果时，脚本应记录退出码和 stderr，而不是继续解析空文本
if ! output=$(findmnt --json --target /data \
  --output=TARGET,SOURCE,FSTYPE,OPTIONS 2>findmnt.err); then
  # 这里可能是路径不存在、过滤条件无匹配或查询本身出错
  printf 'findmnt failed: %s\n' "$(cat findmnt.err)" >&2
  exit 1
fi
printf '%s\n' "$output" | jq -e '.filesystems | length > 0' >/dev/null

官方手册还区分了 --json、--pairs 和 --raw：JSON 适合通用解析，pairs 更像键值对并会对不安全字符做十六进制转义，raw 则是原始表格方向。不要因为看到 --shell 就把 pairs 当成 JSON；它解决的是列名可作为 shell 变量的问题。

最后把字段列表和 util-linux 的最低版本写进脚本说明。某些新列、实验性的内核读取方式或发行版补丁可能并不一致；脚本只读取自己声明的字段，并对新增字段保持忽略，升级时就不必重写整套文本解析。

相关问题

为什么不直接解析 findmnt 默认输出？

默认输出偏向人类阅读，树形字符、列宽和默认字段可能调整。显式 JSON 与列集合才能形成可维护的数据契约。

什么时候必须加 --tree？

只有当父子挂载关系本身是业务数据时才加，例如要解释 overlay 或 bind mount 的嵌套结构；简单清单不需要递归。

--json 和 --pairs 怎么选？

需要通用语言或 jq 解析时选 JSON；只在 shell 中读取键值对时才考虑 pairs，并确认十六进制转义符合你的处理逻辑。

findmnt 返回 1 就代表 JSON 损坏吗？

不代表。findmnt 的非零退出可能表示没有匹配文件系统或查询错误，应先看 stderr 和过滤条件，再决定是否解析输出。