在 Linux 系统管理与服务运维的日常工作中,man 命令是每一位用户和开发者不可或缺的助手,它通过访问系统中的手册页,为我们提供了关于命令、系统调用、库函数等的详细文档,在 CentOS 系统中,尤其是采用最小化安装模式时,man pages 功能可能并未完全配置或可用,本文将详细阐述如何在 CentOS 上检查、安装、配置并优化 man pages,以充分发挥其作为知识库的强大作用。

第一步:检查当前 Man Pages 状态
在开始配置之前,首先需要确认当前系统中 man 命令及其手册库的安装情况,打开终端,执行以下命令:
man man
如果系统能够正常显示 man 命令自身的帮助手册,说明 man 工具已安装,尝试查看一个常用命令的手册,ls:
man ls
如果此命令提示 "No manual entry for ls" 或类似错误,则意味着 man-pages 文档包尚未安装,这是最小化安装 CentOS 时的常见情况。
第二步:安装 Man Pages 核心组件
要使 man 命令完全可用,我们需要安装两个核心组件:man-db(提供 man 命令本身)和 man-pages(提供手册内容),在 CentOS 7 及更高版本中,可以使用 yum 或 dnf 包管理器进行安装。
执行以下命令来安装这些必要的软件包:
sudo yum install man-db man-pages
对于 CentOS 8 或 Stream 系统,推荐使用 dnf:
sudo dnf install man-db man-pages
安装完成后,系统会自动创建手册页的索引数据库,再次尝试 man ls,您应该就能看到关于 ls 命令的详细文档了。
第三步:安装特定软件包的 Man Pages
有时,即使安装了核心组件,某些第三方软件或特定工具的 man pages 仍然缺失,这是因为它们的文档可能被打包在独立的 -doc 或 -manual 子包中。
要获取 Python 3 的官方文档手册,需要安装其对应的文档包:

sudo yum install python3-docs
要查找某个软件包是否提供了独立的文档包,可以使用 yum search 命令:
yum search <package-name>-doc
通过这种方式,可以确保您安装的所有重要工具都配有相应的本地手册。
第四步:配置中文 Man Pages
对于中文用户,能够阅读中文手册页无疑会大大提升效率,配置中文 man pages 主要涉及两个层面:安装中文语言包和设置系统语言环境。
-
安装中文语言支持包 确保系统已安装中文语言包,可以通过安装语言支持组来实现:
sudo yum groupinstall "Chinese Support"
或者,在较新的系统中安装具体的语言包:
sudo yum install langpacks-zh_CN
-
配置系统语言环境 仅仅安装语言包是不够的,还需要告诉系统优先使用中文,这通过设置环境变量
LANG来实现,将以下内容添加到您的个人配置文件~/.bashrc或系统的全局配置文件/etc/profile或/etc/locale.conf中:export LANG=zh_CN.UTF-8
保存文件后,执行
source ~/.bashrc(或重新登录终端)使配置生效,之后,如果某个命令提供了中文手册页,man命令会自动加载中文版本,若没有中文版,则会回退到默认的英文版。
第五步:自定义 Man 命令行为
man 命令的行为可以通过环境变量进行高度定制,以满足个人偏好。
| 环境变量 | 作用 | 示例 |
|---|---|---|
PAGER |
指定用于显示手册内容的分页器,默认通常是 less。 |
export PAGER='less -R' (支持颜色) |
MANPAGER |
类似于 PAGER,但仅对 man 命令生效,优先级更高。 |
export MANPAGER='most' (另一个功能丰富的分页器) |
MANPATH |
指定 man 搜索手册页的额外目录路径。 |
export MANPATH=$MANPATH:/opt/custom_app/man |
为了让手册页显示彩色(高亮代码、关键词等),可以在 ~/.bashrc 中添加:

export LESS="--RAW-CONTROL-CHARS" export MANPAGER="less -R"
这会让 less 解析 ANSI 颜色代码,使阅读体验更佳。
维护与更新
当系统通过 yum update 更新或安装新软件包后,手册页的索引数据库可能不会自动更新,如果发现 man -k 或 apropos 命令找不到新安装的命令,可以手动重建索引:
sudo mandb
此命令会扫描所有手册页目录并更新搜索数据库,确保所有可用资源都能被检索到。
相关问答FAQs
执行 man 命令后提示 "No manual entry for ..." 是什么原因?如何解决?
解答: 这个提示意味着 man 命令在其搜索路径中找不到对应命令或主题的手册文件,主要原因及解决方法如下:
- 未安装手册包:最常见的原因是您只安装了软件本身,而没有安装其手册文档,请使用
yum search <package>-doc查找并安装对应的-doc文档包。 - 软件本身不提供手册:部分较新或非标准的软件可能没有提供传统的 man pages,而是通过
--help选项、info命令或在线文档提供帮助,可以尝试software --help或info software。 - 手册索引数据库过期:如果您刚安装了新的手册包,但
man -k找不到,可能是因为索引数据库未更新,执行sudo mandb命令手动更新数据库即可。
如何让 man pages 显示颜色,使其更易读?
解答: 默认情况下,man 通过 less 分页器显示内容,可能是单色的,要启用颜色高亮,你需要配置 less 使其能够解释 ANSI 转义序列(颜色代码),最简单的方法是在你的 ~/.bashrc 文件中添加以下两行:
export LESS="-R" export MANPAGER="less -R"
-R 参数告诉 less 原始输出控制字符(即 ANSI 颜色代码),保存文件后,执行 source ~/.bashrc 或重新打开一个终端,此后,当你查看 man pages 时,关键词、代码块、文件路径等通常会被高亮显示,显著提升可读性。