企业官网建设流程全解析

1. 先说动机：什么时候你才会想起来用 apropos

用 Linux 的人早晚会遇到这么一幕：你明明知道系统里有个命令能干活，比如“把文件按大小排一下”或者“把目录整个打包发给别人”，可你就是想不起它叫什么。这种时刻，你需要的不是再翻一遍 man，而是 Linux 自带的帮助查找命令 apropos——一个专门按功能描述反查命令名的工具。

apropos 的行为很好理解：你给我一个功能关键词，它把系统里所有 man 手册的 NAME 段（也就是每份手册开头那句“命令名 —— 一句话说明”）都翻一遍，把描述里带这个关键词的手册列出来。apropos editor会把 vi、vim、nano、gedit 全列出来；apropos compress会把 gzip、xz、zip 这一大家子压缩工具都捞出来。说白了，它是把“功能描述”翻译成“命令名”的翻译官。

1.1 man 只能按名字查，这是它最大的盲区

man 是 Linux 下最权威的文档，但它的索引逻辑只有一个：你给出命令名，它定位手册。这就注定了它依赖一个前提——你得先知道名字。现实里大部分查文档的窘境恰恰是不知道名字。比如写脚本时你记得有个命令能“看某个端口有没有被监听”，但你背不出到底是 netstat、ss 还是 lsof。这时候靠 man 纯属碰运气，apropos 这种反向检索补上的正是这个缺口。

1.2 apropos 的定位：按功能描述反查命令名

严格说，apropos 不是“查工具”，而是一个“查索引”的工具。它不打开任何 man 手册的正文，只查一份预生成的数据库，所以速度极快，通常几十毫秒内就能返回结果。在绝大多数发行版上，apropos foo和man -k foo是同一个功能：一个提供独立命令名，一个藏在 man 的选项里，本质上都是查询 whatis 数据库。

这篇内容我给三类人写：第一类是刚接触 Linux、记不住命令的初学者；第二类是运维，随手查漏补缺，省得开浏览器；第三类是写脚本的人，经常要在一堆工具里挑合适的，需要快速列出全部候选。后面从原理讲到参数，再讲几个我实际踩过的坑。

2. 它到底在搜什么：apropos 背后的 man 索引机制

很多人用 apropos 搜不到东西，第一反应是“系统坏了”或者“命令不行”，其实大多数时候是没搞懂它搜的到底是什么。apropos 搜的不是 man 手册的全文，而是每份手册开头的那一小段 NAME 摘要。这个摘要平时没人注意，但它就是整个查询系统的基石。

2.1 whatis 数据库从哪来：mandb 在背后做了啥

Linux 手册安装后，系统并不会自动把全部内容加载进内存。man-db 这套工具链会在安装手册包时运行mandb，逐个扫描/usr/share/man（以及 MANPATH 里能看到的目录）下的手册，把每份手册.SH NAME后面的那一行提取出来，整理成一个精简的文本数据库，也就是常说的 whatis 数据库，常见位置在/var/cache/man/whatis。这个数据库里每行就是一条记录，格式长得像这样：

gzip (1) - compress or expand, convert files to gzip format useradd (8) - create a new user or update default new user information

左半部分是命令名加手册章节，右半部分是一句话说明。apropos 每次执行，实际就是在这一堆记录里做字符串匹配。所以它的快是必然的——它从来就没打开过完整的手册正文。

这里有个容易踩的初装坑：某些精简安装、Docker 容器或者最小化系统里，只有man-db这个程序，却压根没安装manpages数据包，或者数据库一直没生成。这时候执行apropos 任何词，都会得到 “nothing appropriate” 的报错，看起来像命令失效，其实只是没有数据。修复动作很简单，sudo mandb重建索引就能看到类似下面的输出：

$ sudo mandb [告诉你扫描了哪些目录] 一共生成了 N 条索引

老一点的发行版（尤其是早年间的 RHEL/CentOS）叫法是makewhatis，原理一样；现在主流发行版基本统一到 man-db 的mandb了。我自己在办公电脑上换过好几次发行版，每次新装完系统，第一件事就是把常用手册包装好、跑一遍 mandb，免得后来查命令查个寂寞。

2.2 apropos、whatis、man -k 的关系

这几个命令很容易搞混，其实一句话就能理清：

apropos 和 whatis 的差别尤其典型：whatis grep会把 grep 的手册摘录取出来；apropos grep则会匹配到所有摘要里含有 grep 这个词的手册，比如 egrep、zgrep、pgrep，甚至可以匹配到类似 “grep-like tool” 的第三方手册。所以前者是查名，后者是查义。

2.3 为什么它搜不到 man 正文里的内容

这是大家最容易误解的一点。apropos compress能列出一堆压缩工具，但如果你搜的词只出现在手册正文某一段、没有写进 NAME 摘要，它就不会出现。NAME 摘要通常只有一句话，是手册作者自己写的“广告词”，他没用某个词，你就搜不到。

比如 grep 手册的摘要可能写成 “print lines that match patterns”，里面没有 “search” 这个词，所以在某些发行版上apropos search反而搜不出 grep。这是正常的，不是命令坏了。这个特性也解释了另一件事：为什么有时候搜到命令名之后，你还要man进去再看一眼详细用法。因为摘要只能告诉你“有这么个工具”，具体选项、参数、退出码全都要靠正文补充。想要全文搜索得换工具，这个我放到后面“什么时候不该用 apropos”里专门讲。

3. 基础用法：从第一条命令到看懂输出

熟记一个命令最靠谱的方式是在真实输出里多过几遍眼睛。下面所有例子我都直接放输出，默认你已经装好了 man-db 和常用手册。

3.1 一条命令跑通：apropos 关键词

$ apropos editor ed (1) - line-oriented text editor editor (1) - Vi IMproved, a programmers text editor ex (1) - Vi IMproved, a programmers text editor gedit (1) - a small and lightweight text editor for GNOME nano (1) - a small friendly text editor vi (1) - Vi IMproved, a programmers text editor vim (1) - Vi IMproved, a programmers text editor

输出分三列，第一列是命令名，括号里是手册章节，后面是摘要。不同系统装的手册不一样，筛出来的条数会有出入，这很正常，不用纠结。看输出时第一列是你要的结果，第二列括号里的数字决定了你看手册时怎么叫章节。比如nc (1)说明这款 nc 在用户命令这一章，直接man nc就行；如果是nc (8)，说明它可能是系统级工具，得用man 8 nc才能定位到正确的那份手册。

3.2 精确匹配 -e 和忽略大小写 -i

默认情况下 apropos 使用的是正则匹配，关键词会被当成正则表达式解释。这意味着apropos compress会匹配到 compress、compressed、compressing 等等变体。多数时候这种模糊挺好，但你只想看摘要里“正好有 compress 这个词”的时候，用-e转成精确匹配：

$ apropos -e compress compress (1) - compress and expand data compress (1p) - compress and expand data (POSIX) uncompress (1) - compress and expand data

注意，gzip 这种摘要里写 “compress or expand” 的反而不会进来，因为-e要求的是 “compress” 作为一个独立的完整匹配单位，而不是 “compressed” 这类派生词。想同时忽略大小写，加-i：

$ apropos -i -e ssl

-i在默认正则模式下也能用，但最典型的场景就是和-e搭配，比如你想找 “SSL” 又怕手册里写成 “ssl”，一个-i就把两个都覆盖了。

3.3 只看某个章节 -s

Linux 手册分章节，常用的是这几章：

• 1：用户命令
• 2：系统调用
• 3：C 库函数
• 4：设备文件
• 5：配置文件格式
• 7：杂项/协议约定
• 8：系统管理命令

同样是open，第 1 章可能是某个叫 open 的软件，第 2 章才是打开文件的系统调用。apropos -s 2 open就能精准锁定系统调用：

$ apropos -s 2 open open (2) - open and possibly create a file or device openat (2) - open and possibly create a file or device openat2 (2) - open and possibly create a file or device

如果你做开发，把apropos -s 2,3的用法记住，查 POSIX 函数的效率会高很多。但前提是你装了开发手册，Debian/Ubuntu 上是manpages-dev、manpages-posix-dev这类包，没装的话第 2、3 章的手册几乎是空的，搜了也是白搜。

3.4 交叉匹配 -a：多个关键词同时命中

apropos 支持多个关键词，默认是“或”的关系，搜出来会非常宽。想缩小范围就用-a，要求所有关键词都必须出现在同一条摘要里：

$ apropos -a network traffic tcpdump (8) - dump traffic on a network tshark (1) - dump and analyze network traffic

-a network traffic的意思是“摘要里既要出现 network 又要出现 traffic”，一下子就把范围收窄到网络抓包类工具。这个参数在候选多到看不过来时尤为好用。

到这一步，基础四招已经齐全：-e精确、-i忽略大小写、-s限章节、-a多关键词 AND。任何一个搭配组合，都够应付日常 90% 的查询了。

4. 高级检索：正则、通配符与搜索策略

基础参数足够日常，但真要高效起来，还得学会控制匹配方式。apropos 默认就走正则，所以你对正则懂多少，它就能多聪明。

4.1 默认就是正则：抓住开头、结尾和分组

正则最朴素的用法是约束位置。比如你想查所有以 user 开头的手册：

$ apropos '^user' useradd (8) - create a new user or update default new user information userdel (8) - delete a user account usermod (8) - modify a user account

这里的^是正则里的“行首锚点”，意思是摘要记录开头必须出现 user。反过来，想匹配结尾可以用$锚点，理解原理就好。真正好用的是“或”语法：apropos 'copy|rename'会同时把摘要里含 copy 或 rename 的手册捞出来，比如 mv 的摘要 “move (rename) files” 就会命中。多条件组合时，括号还能把条件归组，比如查“直接映射”或“线性映射”类的工具，可以写成apropos '(direct|linear).*(map|mapping)'。这类组合在常规查询里用得不多，但明白这个机制后，你至少不会对某些奇怪输出感到震惊。

4.2 通配符 -w：给手残党用的正则

正则好归好，可写起来要小心转义。如果你只想要模糊匹配效果，-w更省心，它把关键词里的*?当通配符处理：

$ apropos -w 'net*' netcat (1) - TCP/IP networking utility netstat (8) - Print network connections, routing tables, interface statistics...

*表示前面的字符可以出现任意次，?表示单个字符。-w与-r（正则）是互斥的。实际查询我更偏爱-w，因为不用记\.转义，写出来像日常搜索习惯。

4.3 组合策略：多关键词 + 管道过滤

apropos 的输出本身就是一份候选清单，用管道再接一个 grep 做二次过滤是最常见的组合拳：

$ apropos process | grep -i signal kill (1) - send a signal to a process killall (1) - kill processes by name pkill (1) - send a signal to a process

先apropos process把进程相关手册都列出来，再用 grep 在里面筛 signal，比直接输入apropos -a process signal更灵活，因为 grep 还能再叠一层条件，比如排除某些词：apropos process | grep -i signal | grep -v kill。

4.4 把输出按命令名排序：sort 的妙用

输出顺序默认不是按命令名排的，是数据库里的自然顺序。想看候选名单时就地排一下：

$ apropos -l network | sort -k1,1

-l是“不要截断长描述”的意思，默认输出为了适应终端宽度会砍掉描述的后半截，管道重定向时最好都带上。sort -k1,1按第一列排序。这一步对脚本处理很关键，因为命令名字段是稳定的，你甚至可以cut -d' ' -f1把命令名单独抽出来，再喂给下一个命令做批量操作。

5. 实战工作流：从一句话需求到敲出正确命令

参数再多不如跑一遍。下面几条是我工作里反复用到的“搜索路线图”，每条都从需求出发，演示怎么从一句话走到正确的命令名。

5.1 “把目录打包成压缩文件”怎么查

需求描述里最有信息量的词是“打包、归档”。第一反应敲：

$ apropos "archiv" ar (1) - create, modify, and extract from archives tar (1) - an archiving utility zip (1) - package and compress (archive) files 7z (1) - A file archiver with highest compression ratio

结果一眼能看出tar最通用，zip更偏跨平台交换场景，7z压缩率高但目标机器不一定有。如果你需要的是“把目录打成 .tar.gz”，看完这条候选就能敲出tar -czvf xxx.tar.gz dir。这里我不建议一上来就搜compress，因为压缩类工具太多，候选容易上百；先搜“归档”再挑，候选列表短，决策更快。

5.2 查端口、抓包，想不起工具拼写

排查网络问题时，嘴里念叨着“我得抓个包”，名字卡在嘴边。两条路线都能走：

$ apropos "network" | grep -i dump tcpdump (8) - dump traffic on a network tshark (1) - dump and analyze network traffic

或者直接apropos -a network traffic，结果同上。这类需求用“名词+动词”的 AND 组合特别准，一眼就能圈定目标。

5.3 找文件权限/ACL 相关命令

写脚本要查当前目录的 ACL，卡在 setfacl/getfacl 哪个是设置、哪个是查询。摘要里直接带词就能定：

$ apropos "access control" getfacl (1) - get file access control lists setfacl (1) - set file access control lists

注意这里直接写access control就行，因为正则里空格就是“任意位置放一个空白”，恰好能精确匹配摘要里的 “access control lists”。这类“短语搜索”是所有正则技巧里最实用的一个。

5.4 开发查系统调用：锁定章节

写 C 程序想确认read系统调用的返回值约定，apropos read太宽。直接指定章节：

$ apropos -s 2 read read (2) - read from a file descriptor readv (2) - read data into multiple buffers

-s 2一加，候选立刻从“几百条 read 相关”收缩到“系统调用 read”，再用man 2 read打开正确的手册。很多新手不知道man 2 read和man read可能各不相同——第 1 章可能有个叫 read 的用户命令，第 2 章才是系统调用。章节概念配合-s过滤，能少走很多弯路。

5.5 给终端加个“查命令名”的快捷函数

熟练之后，我把这套查询写到了.bashrc/.zshrc里，一个函数搞定“查名 + 打开手册”：

cap() { local cmd cmd=$(apropos -l -s 1 "$1" 2>/dev/null | head -n1 | awk '{print $1}') if [ -n "$cmd" ]; then man "$cmd" else echo "no command found for: $1" fi }

用法：cap network找到第一条用户命令并直接打开它的手册。2>/dev/null是为了避免某些章节没手册时报错刷屏。这个函数很简单，但每天给我省下不少时间。

6. 踩坑与排查：搜不到结果时别急着重装系统

apropos 最让人困惑的报错就是 “nothing appropriate”。我见过不少同事跑出这句话后第一反应是重装系统或者换发行版，其实就那么几个原因，逐个排查几分钟就解决。

6.1 “nothing appropriate” 的三大原因

按频率排序，基本是这三种情况：

第三种情况比较隐蔽。有些软件安装器会在~/.bashrc里设置 MANPATH，如果设成了只包含自家手册目录，系统默认的/usr/share/man就不在查询范围内了。执行manpath看当前搜索路径，就能定位问题。我自己就曾经因为某次调试把 MANPATH 指向了一个临时目录，结果第二天发现 man 和 apropos 全“失灵”，恢复环境变量后一切正常。

另外还有一个很多人忽略的点：如果你是用源码编译第三方的手册、自己复制进/usr/local/share/man，不会自动触发 mandb。得手动跑一次sudo mandb，把新复制的手册登记进索引，apropos 才能搜到。这个细节在装完某些自定义工具后特别容易翻车。

6.2 默认正则的坑：.、(、+会被当元字符

默认正则检索意味着关键词里的很多符号都有特殊含义。最典型的是搜带点的东西：

$ apropos "tar.gz"

你以为搜的是 “tar.gz” 这个字符串，但正则里.能匹配任意字符，它实际匹配的可能根本不是你想的东西。解决方案有两个：一个是用-e精确匹配，另一个是把点转义成tar\.gz。同理，想搜含括号的说明时，直接写括号会语法报错，也得转义。所以我的经验是：凡是关键词里有特殊符号，先考虑-e，不要和正则硬刚。

6.3 搜不到 shell 内置命令很正常

apropos cd通常返回 nothing appropriate。因为cd是 shell 内置命令，它不是独立的手册条目，而是写在 bash 手册的“内置命令”那一节里。这时候该用的是 bash 自带的帮助系统：

$ help cd

还要查一个命令到底是不是内置命令，可以type -a cd。这个知识点和 apropos 本身无关，但它解释了为什么有的命令“怎么搜都没有”——它们根本不在 whatis 索引里。同样的还有alias、export、source这些。

6.4 什么时候不该用 apropos：备选工具链

• 全文搜索：脑子里只有一个特别生僻的词、大概率不在摘要里，用man -K 关键词做全文搜索，它会遍历所有手册正文，速度慢但能救命。
• 已知命令名，想看它在哪：用whatis 命令名或man -w 命令名，后者直接输出手册文件路径。
• GUI 程序/小众工具：某些工具没有 man 页，只有--help或者包自带的文档，apropos 搜不到不代表它不存在。
• 要快速看常用命令的精简用法：可以装tldr，它提供社区维护的示例式手册。注意 tldr 同样需要你给出命令名，它是来替换 man 的，替代不了 apropos 的“反查”功能。

7. 让 apropos 变成你自己的命令搜索引擎

最后这个玩法很少有人提：既然 apropos 只是检索 whatis 数据库，那你自己写的脚本也可以被它搜到。对运维团队来说，把内部脚本整理成 man 页放进系统手册目录，等于给全组人发了一本“命令词典”。

7.1 给自己写的脚本写一个 man 页

比如我有个备份脚本叫mybkp，想让它能被apropos backup搜到。先写一个最简 man 页，格式用 groff：

.TH MYBKP 1 "2024-01-01" "v1.0" "User Commands" .SH NAME mybkp \- backup specified directories to an archive .SH SYNOPSIS .B mybkp [\fIOPTIONS\fR] \fISRC\fR... .SH DESCRIPTION .B mybkp backs up the given directories into a single tarball.

关键就一句话：.SH NAME下面必须写成名字 \- 一句话说明的格式，因为 mandb 靠解析这段生成 whatis 记录。把文件放到/usr/local/share/man/man1/下（文件名后缀 .1），然后更新数据库：

$ sudo install -m 0644 mybkp.1 /usr/local/share/man/man1/ $ sudo mandb

之后apropos backup就能搜到 mybkp 了。没有 root 权限的环境，也可以把手册放进~/man/man1/，设置export MANPATH="$HOME/man:$MANPATH"，再执行mandb --user-db，效果一样。

7.2 组内脚本文档化的实际收益

前几年我管理的一批服务器上，光内部脚本就有上百个，新同事来了全靠口头传承，问一句答一句。后来我花了两个下午，给最常用的二十来个脚本各写了一个上面的最小 man 页，一条sudo mandb建好索引。从那以后，同事要找一个“把日志按时间切分归档”的脚本，直接apropos -a log archive，名字和用法都出来了。这个投入产出比高得惊人——写一个 man 页的难度低于写一份 wiki 页，因为它就在终端里，离问题现场最近。

我个人现在养成的习惯是：每次新写一个能复用的脚本，都顺手补一个最小 man 页。也不是说每个小工具都要进 man 体系，而是当你的环境里真的积累了几十个内部工具时，一个可搜索的索引比任何文档系统都顺手。下次你听到同事问“有没有个命令能干 XXX”，先别急着开浏览器，敲一条apropos XXX，也许它早就在你的系统里等着了。