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 结果可能过时,两者也不能保证找到所有文件。




