Linux whereis 命令:查找二进制、源文件与手册的位置

whereis 按程序名查找相关的二进制文件、源文件和手册页。它适合一起查看这些文件的位置;若要判断当前 shell 实际如何解析命令,应另用 type 或 command -v。

本文以 Linux 的 util-linux 实现为准。它结合内置的常见目录及 PATH、MANPATH 等环境信息建立搜索范围,不会递归遍历整个文件系统,也不依赖 locate 的路径数据库。非标准安装目录可能需要单独指定。

基本语法

whereis [OPTION]... NAME...

OPTION、NAME 是占位符,应替换为选项和实际程序名。先用 whereis --version、whereis --help 和 man whereis 核对已安装版本;其他系统的同名工具及较旧版本可能不同。whereis 不属于 shell 的名称解析功能。

whereis 的基本用法

查找程序的相关位置

下面查询 bash。通常输出以 bash: 开头,后面列出找到的相关文件路径。实际结果取决于系统安装内容和搜索目录,不能预先保证一定包含二进制、源文件和手册三种类型。

whereis bash

只搜索二进制文件类别

小写 -b 选择二进制类别。下面按 ssh 名称查询该类别的目录;找到相关文件不代表 SSH 服务已启用,更不代表主机可以连接。

whereis -b ssh

只搜索手册

-m 选择手册类别,util-linux 的该类别也包括 Info 文档位置。下面查找 printf 的文档文件,不运行 printf;系统若未安装对应文档,可能只显示名称标签。

whereis -m printf

如何区分二进制和手册的位置?

下面用 ls 查看混合结果。后面的路径仅为示意,安装目录、手册章节和压缩格式都可能不同。

whereis ls

可能的输出:

ls: /usr/bin/ls /usr/share/man/man1/ls.1.gz

这里 /usr/bin/ls 是程序路径,ls.1.gz 是压缩的第 1 节手册文件。不要把输出理解为“shell 先执行第一条路径”:whereis 不是执行优先级工具。可分别运行 whereis -b ls 和 whereis -m ls 核对类别,再在实际 shell 中用 command -v 与 command -V 查看名称解析。

结果按名称匹配,并不保证文件有执行权限、解释器可用或内容可信。源文件也可能未随二进制软件包安装。若只看到 ls: 等标签,应检查范围和错误信息,不能直接断定软件在整台机器上不存在。

常用选项

选项 用途与条件
-b 选择二进制文件类别,不保证结果能实际执行。
-m 选择手册与 Info 文档类别。
-s 选择源文件类别。
-B DIRS -f 替换二进制类别的搜索目录;不会自动排除其他类别。
-M DIRS -f 替换手册类别的搜索目录;可与 -m 配合。
-S DIRS -f 替换源文件类别的搜索目录;可与 -s 配合。
-u 筛选不常见的条目;具体规则应核对本机版本,不能作为软件安装检测。
-l 列出工具实际使用的查找目录。

小写选项选择文件类别,大写选项设置该类别的目录。只用 -B 并不等于只查二进制;需配合 -b。目录列表用空格分隔,单个目录若含空格应加引号;-f 表示目录列表结束,后面开始提供要查询的名称。

实用示例

先检查搜索目录

遇到结果缺失或与预期不同,先查看搜索范围。列表通常用 bin、man、src 区分类别;目录是否存在、是否可读及当前环境都可能影响实际列表。

whereis -l

自定义二进制目录后的范围可用 whereis -B /usr/local/bin -f -l 检查;这里的 -l 列出目录,不代表已经找到了某个文件。不要因为默认列表有 /opt 下的一些目录,就认为任意多层安装树都会被递归搜索。

在自定义目录中查找二进制类别

在一个可写练习目录中,用 Bash 执行以下完整示例。它新建 whereis-demo 并生成一个演示脚本,仅查询该名字,不运行脚本。若 whereis-demo 已存在,mkdir 会让子 shell 退出;请另选新名字,不要覆盖已有内容。

(
  mkdir whereis-demo || exit 1
  cd whereis-demo || exit 1
  mkdir bin || exit 1
  printf '#!/bin/sh\nexit 0\n' > bin/mytool || exit 1
  chmod +x bin/mytool || exit 1
  whereis -b -B "$PWD/bin" -f mytool
)

在具有 util-linux whereis 的 Linux 环境中,应得到 mytool: 加上练习目录内 bin/mytool 的完整路径。-b 限定类别,-B 指定该类别目录,-f 分隔目录与名称。括号结束后,父 shell 工作目录保持原样,练习文件留在 whereis-demo。

若没有路径,先确认文件确实创建成功、目录可读且选项受支持。这个查询不会修改系统目录,也不会把练习目录加入系统 PATH。手册或源文件目录可按相同原则使用 -m/-M 或 -s/-S,但应指定对应文件实际所在目录。

结合 shell 解析结果诊断

先问当前 shell 能否解析 python3,再查看该名称的相关文件。二者用途不同,输出不需要相同;第一条可能找到别名或函数,第二条可能只找到文档。也可能两者都找不到。

command -v python3
whereis python3

如果第一条失败,第二条仍会继续执行;整段最后的退出状态也不能代表第一条成功。脚本若要检查某个名称是否可用,应单独判断 command -v 的状态,不能把 whereis 的退出状态直接当成“已经安装”的证明。

whereis 与相关命令如何选择?

命令 主要作用 适用场景
whereis 搜索已知目录中的程序相关文件 一起定位二进制、源文件与手册。
which 查找 PATH 中的外部可执行候选 快速查询程序路径,选项与包装行为依实现而异。
type 解释当前 shell 中的命令类型 诊断别名、函数、内置命令和外部文件。
find 直接遍历指定目录树 搜索自定义位置并结合名称、时间、大小等条件。

使用时应注意什么?

搜索范围有限,也不是索引查询

whereis 不会为了每个名称遍历整个磁盘。确认某个目录的当前内容可用 find 遍历指定目录树;若需要名称索引查询,可用 locate,但要考虑索引更新和排除规则。选择合适范围比直接扫描所有目录更容易核对结果。

通常应传程序名,而不是路径

util-linux 会去掉查询参数前面的目录部分,因此 whereis /some/path/ls 不表示只检查 /some/path。手册和源文件匹配还涉及相应后缀规则,不要把它当成任意完整路径的精确存在性检测。若要限定目录,应明确使用对应的大写选项。

确认类别、目录和 -f 的位置

目录名单后要加 -f,再提供程序名。多个类型选项可以组合;官方示例 whereis -bm ls tr -m gcc 对 ls、tr 查二进制和手册,随后对 gcc 只查手册。复杂调用应按组核对选项作用范围,不能假定一个查询的条件永远沿用到所有后续名称。

-u 是筛选模式,不适合直接判断“有无安装”。需要解释空结果时,先去掉 -u,明确选定类别,检查普通查询及 -l 的范围,再核对实际文件。不要通过提升权限来掩盖范围或类别设置错误。

常见问题

whereis 只搜索 PATH 吗?

不是。util-linux 使用内置的常见二进制、源文件、文档目录,并考虑 PATH、MANPATH 等环境提供的位置。应以当前查询的 -l 结果和自定义选项为准。

为什么自定义安装没有显示?

目录可能不在搜索范围中,也可能选错类别、文件名不匹配或目录不可读。先确认实际文件,再用对应的大写选项指定目录;查二进制时可组合 -b、-B 和 -f。

如何查看搜索路径?

util-linux 支持 whereis -l。修改搜索目录后也应重新查看列表,确认参数作用范围,不要把目录列表误认为命令的匹配结果。

如何在更广的范围查找文件?

用 find 从已知目录开始直接遍历,或用 locate 查询已建立的名称索引。find 受遍历权限和并发变化影响;locate 结果可能过时,两者也不能保证找到所有文件。

相关资料与官方文档