Ranger 完全指南：终端里的 Vim 式文件管理器

pip install ranger-fm
# 或
pipx run --spec ranger-fm ranger

brew install ranger

sudo apt install ranger

sudo pacman -S ranger

git clone https://github.com/ranger/ranger.git
cd ranger
python ranger.py

ranger --version

ranger --copy-config=all

set viewmode miller           # 默认三列布局
set column_ratios 1,3,4       # 三列宽度比
set show_hidden true          # 显示隐藏文件
set preview_files true        # 启用文件预览
set preview_images true       # 启用图片预览
set preview_images_method kitty  # 图片预览方式（kitty/ueberzug/sixel）
set vcs_aware true            # 显示 Git 状态标记
set draw_borders both         # 面板边框

alias ra='ranger'

ranger_cd() {
    local tmp="$(mktemp -t ranger_cd.XXXXXX)"
    ranger --choosedir="$tmp" -- "${@:-$(pwd)}"
    if chosen_dir="$(cat -- "$tmp")" && [ -n "$chosen_dir" ] && [ "$chosen_dir" != "$(pwd)" ]; then
        cd -- "$chosen_dir"
    fi
    rm -f -- "$tmp"
}
alias ra='ranger_cd'

ranger() {
    if [ -z "$RANGER_LEVEL" ]; then
        /usr/bin/ranger "$@"
    else
        exit
    fi
}

set preview_images true
set preview_images_method kitty    # kitty 终端用户
# set preview_images_method ueberzug  # 其他终端
# set preview_images_method sixel     # 支持 Sixel 的终端

# 文本文件用 $EDITOR 打开
mime ^text, label editor = nvim -- "$@"

# PDF 用 zathura
ext pdf = zathura -- "$@"

# 图片用 feh
mime ^image, has feh = feh -- "$@"

# 视频用 mpv
mime ^video, has mpv = mpv -- "$@"

# 兜底：用 xdg-open
else = xdg-open "$1"

from ranger.api.commands import *

import os
from ranger.core.loader import CommandLoader

class extract_here(Command):
    """:extract_here
    用 atool 解压选中的文件到当前目录。
    """
    def execute(self):
        cwd = self.fm.thisdir
        marked = tuple(cwd.get_selection())
        if not marked:
            return
        original = cwd.path
        au_flags = ['-x', cwd.path, '-e']
        obj = CommandLoader(
            args=['aunpack'] + au_flags + [f.path for f in marked],
            descr="解压文件",
            read=True,
        )
        obj.signal_bind('after', lambda _: cwd.load_content())
        self.fm.loader.add(obj)

import os
import subprocess

class fzf_select(Command):
    """:fzf_select
    用 fzf 模糊搜索并跳转到选中的文件或目录。
    """
    def execute(self):
        command = "find -L . \\( -path '*/\\.*' -o -fstype 'dev' -o -fstype 'proc' \\) " \
                  "-prune -o -print 2>/dev/null | sed 1d | cut -b3- | fzf +m"
        fzf = self.fm.execute_command(command, stdout=subprocess.PIPE)
        stdout, _ = fzf.communicate()
        if fzf.returncode == 0:
            selected = os.path.abspath(stdout.decode('utf-8').strip())
            if os.path.isdir(selected):
                self.fm.cd(selected)
            else:
                self.fm.select_file(selected)

map <C-f> fzf_select

if vim.fn.executable("ranger") == 1 then
  vim.keymap.set("n", "<leader>R", function()
    Snacks.terminal("ranger", { cwd = LazyVim.root() })
  end, { desc = "Ranger" })
end