Canop/broot 跨平台安装指南：从入门到精通

Canop/broot 跨平台安装指南：从入门到精通

broot A new way to see and navigate directory trees : https://dystroy.org/broot 项目地址: https://gitcode.com/gh_mirrors/br/broot

项目简介

Canop/broot 是一款功能强大的终端文件管理器，支持 Linux、macOS 和 Windows 10+ 系统。它通过直观的交互界面和丰富的功能特性，帮助开发者高效地浏览和管理文件系统。

系统要求

broot 支持以下操作系统：

• Linux (各主流发行版)
• macOS
• Windows 10 及以上版本

安装方式概览

broot 提供多种安装方式，用户可根据自身需求选择：

1. 预编译二进制文件（推荐新手）
2. 通过 Rust 包管理器 cargo 安装
3. 从源码编译安装
4. 通过第三方软件仓库安装

预编译二进制安装

这是最简单的安装方式，适合大多数用户。broot 为不同平台提供了预编译好的二进制文件：

Linux 平台

• x86_64 架构（现代 Linux 发行版）
• x86_64 架构（兼容旧版 glibc）
• x86_64 musl 版本（兼容性最好）
• ARM32/ARM64 架构（树莓派等设备）

Windows 平台

• x86_64 架构（Windows 10+）

安装步骤

1. 下载对应平台的二进制文件
2. 将文件移动到系统 PATH 包含的目录（如 /usr/local/bin）
3. 赋予可执行权限：chmod +x broot

通过 Cargo 安装

对于 Rust 开发者，推荐使用 cargo 进行安装：

前置依赖

1. 安装最新版 Rust 工具链
2. 安装系统依赖库

各 Linux 发行版依赖安装命令：

• Debian/Ubuntu:

  sudo apt install build-essential libxcb1-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev -y
  

• Fedora/Centos/RHEL:

  sudo dnf install libxcb -y
  

安装命令

基础安装：

cargo install --locked broot

如需剪贴板支持：

cargo install --locked --features clipboard broot

从源码编译安装

适合需要自定义功能的开发者：

1. 克隆项目仓库
2. 进入项目目录
3. 执行安装命令：

   cargo install --locked --path .
   

如需剪贴板支持：

cargo install --locked --features clipboard --path .

第三方软件仓库安装

各系统包管理器安装方式：

macOS

• Homebrew:

  brew install broot
  

• MacPorts:

  sudo port install broot
  

Windows

• Scoop:

  scoop install broot
  

Linux 发行版

• Alpine Linux:

  apk add broot
  

• Gentoo:

  emerge broot
  

安装后配置

1. 安装 br shell 函数：这是 broot 的辅助工具，提供更便捷的 shell 集成

2. 配置编辑器：修改 verbs.hjson 配置文件，设置您偏好的文本编辑器

3. 更新配置：如果是升级安装，建议备份旧配置后让 broot 生成新配置

Windows 用户注意事项

1. 首次运行时可能需要管理员权限来写入配置文件
2. 某些情况下冒号(:)可能有问题，可以用空格替代
3. 推荐使用现代终端，如 Windows Terminal

常见问题解决

1. 编译失败：通常是因为 Rust 版本过旧，运行 rustup update 更新工具链
2. 依赖缺失：根据系统提示安装缺少的开发库
3. 权限问题：确保安装目录有写入权限

通过以上方式，您可以在各种平台上顺利安装并使用 broot 这一强大的文件管理工具。

broot A new way to see and navigate directory trees : https://dystroy.org/broot 项目地址: https://gitcode.com/gh_mirrors/br/broot