ranger

Ranger 是一款采用 VI 按键绑定的控制台文件管理器。它提供简洁美观的 curses 界面，可查看目录层次结构。 它还附带 rifle，这是一款文件启动器，擅长自动判断不同文件类型应使用哪个程序打开。

对于 mc 爱好者，Ranger 还提供多窗格视图模式。

本文档介绍 Ranger 以及如何运行它。有关使用说明，请阅读 man 手册页（在终端中运行 man ranger）。开发相关信息请参阅 HACKING.md。

有关配置，请查看 ranger/config/ 中的文件，或使用 ranger --copy-config 将默认配置复制到 ~/.config/ranger（参阅说明）。

examples/ 目录包含一些脚本和插件，用于演示如何扩展 Ranger 或将其与其他程序结合使用。这些文件可在 Git 仓库或 /usr/share/doc/ranger 中找到。

给打包维护者的说明：用于打包的版本列在网站的变更日志中。

关于

• 作者： 参见 AUTHORS 文件
• 许可证： GNU 通用公共许可证第 3 版
• 网站： https://ranger.fm/
• 下载： https://ranger.fm/ranger-stable.tar.gz
• Bug 报告： https://github.com/ranger/ranger/issues
• git 克隆 https://github.com/ranger/ranger.git

设计目标

• 使用高级语言编写易于维护的文件管理器
• 快速切换目录并浏览文件系统
• 保持小巧实用，专注做好一件事
• 基于控制台，并与 Unix shell 平滑集成

功能

• 支持 UTF-8（如果你的 Python 版本支持）
• 多列显示
• 预览所选文件／目录
• 常见文件操作（创建／chmod／复制／删除／……）
• 一次重命名多个文件
• 类 VIM 的控制台和快捷键
• 自动判断文件类型并使用正确的程序打开
• 退出 Ranger 后更改 shell 的当前目录
• 标签页、书签、鼠标支持……

依赖项

• Python（>=2.6 或 >=3.1），带有 curses 模块 并且（可选）支持宽 Unicode
• 分页器（默认使用 less）

可选依赖

常规使用：

• file，用于确定文件类型
• chardet（Python 软件包），用于更准确地检测文本文件的编码
• sudo，用于使用“以 root 身份运行”功能
• python-bidi（Python 软件包），用于正确显示从右向左书写的文件名 （希伯来语、阿拉伯语）

增强文件预览功能（使用 scope.sh）：

• img2txt（来自 caca-utils），用于预览 ASCII 艺术图像
• w3mimgdisplay、ueberzug、mpv、iTerm2、kitty（或其他支持 Kitty 图形协议的终端）、terminology 或 urxvt，用于预览图像
• convert（来自 imagemagick），用于自动旋转图像和预览图像
• rsvg-convert（来自 librsvg）， 用于预览 SVG
• ffmpeg 或 ffmpegthumbnailer，用于生成视频缩略图
• highlight、bat 或 pygmentize，用于代码语法高亮
• atool、bsdtar、unrar 和/或 7zz，用于预览归档文件
• bsdtar、tar、unrar、unzip 和/或 zipinfo（以及 sed），用于将 归档文件的首张图像作为预览
• lynx、w3m 或 elinks，用于预览 HTML 页面
• pdftotext 或 mutool（以及 fmt），用于文本形式的 pdf 预览；pdftoppm 用于 以图像形式预览
• djvutxt，用于文本形式的 DjVu 预览；ddjvu 用于以图像形式预览
• calibre 或 epub-thumbnailer，用于预览电子书图像
• transmission-show，用于查看 BitTorrent 信息
• mediainfo 或 exiftool，用于查看媒体文件信息
• odt2txt，用于处理 OpenDocument 文本文件（odt、ods、odp 和 sxw）
• python 或 jq，用于处理 JSON 文件
• sqlite3，用于列出 SQLite 数据库中的表（也可选用 sqlite-utils，以绘制更精美的边框。）
• jupyter nbconvert，用于处理 Jupyter Notebooks
• fontimage，用于预览字体
• openscad，用于预览 3D 模型（stl、off、dxf、scad、csg）
• draw.io，用于预览 draw.io 图表 （drawio 扩展名）

安装

使用操作系统的软件包管理器安装 ranger。 你也可以通过 PyPI 安装 ranger：pip install ranger-fm。 不过，建议改用 pipx （以使用隔离环境）。使用 pipx run --spec ranger-fm ranger，即可一步完成 ranger 的安装和运行。

查看当前版本：

### 从克隆版本安装 请注意，你*不必*安装 ranger；直接运行 `ranger.py` 即可。

手动安装 ranger：

sudo make install

大致相当于：

sudo python setup.py install --optimize=1 --record=install_log.txt

此操作还会将所有已安装文件的列表保存到 install_log.txt，你可以用它来卸载 ranger。

入门

启动 ranger 后，你可以使用方向键或 h j k l 导航，按 Enter 打开文件，或按 q 退出。第三列显示当前文件的预览。第二列是主列，第一列显示父目录。

如果使用开关 --copy-config=( rc | scope | ... | all ) 运行，Ranger 可以自动将默认配置文件复制到 ~/.config/ranger。有关此开关的说明，请参阅 ranger --help。此外，也可以查看默认配置 ranger/config/。

深入了解

• 若要充分利用 ranger，请阅读官方用户指南。
• 常见问题请参阅 FAQ。
• 有关自定义的更多信息，请参阅 wiki。

社区

如需帮助、支持，或只是想和大家交流，可以在这里找到我们：

• IRC：在 Libera.Chat 上加入频道 #ranger。没有 IRC 客户端？通过网页聊天加入我们！
• Reddit：r/ranger