安装

概述

Ripgrep 可以通过多种方式安装

使用预编译的二进制文件
通过特定于操作系统的包管理器
从源代码构建

ripgrep 的二进制文件名为 rg。

预编译的二进制文件

为 Windows、macOS 和 Linux 平台上的每个release 提供了预编译的二进制文件。这是最简单的安装方法，可确保您获得最新版本。

对于 Linux 和 Windows，提供了静态可执行文件，这意味着它们没有外部依赖项。

来源: README.md233-241

Debian/Ubuntu 使用 .deb 安装

对于基于 Debian 的发行版，每个版本都提供了一个 .deb 包

来源: README.md338-341

包管理器

Ripgrep 在各种操作系统的包存储库中都有提供。

macOS

Homebrew:

MacPorts:

来源: README.md242-254

Windows

Chocolatey:

Scoop:

Winget:

来源: README.md256-277

Linux 发行版

Arch Linux

Debian/Ubuntu

Fedora

openSUSE

RHEL/CentOS 7/8

Gentoo

Void Linux

ALT Linux

Nix

Flox

Guix

来源: README.md278-333

BSD 系统

FreeBSD

OpenBSD

NetBSD

来源: README.md371-391

Haiku

Haiku x86_64

Haiku x86_gcc2

来源: README.md392-404

从源代码构建

如果想要最新的开发版本或需要自定义构建，从源代码构建很有用。

先决条件

Rust 1.72.0 或更高版本
Git（用于克隆仓库）

基本构建

二进制文件将位于 ./target/release/rg。

来源: README.md434-449 Cargo.toml27

构建支持 PCRE2 的版本

PCRE2 支持增加了额外的正则表达式功能，如环视和反向引用

这适用于稳定的 Rust 编译器，并会尝试使用 pkg-config 查找并链接到您的系统 PCRE2 库。如果找不到系统库，它将从源代码构建 PCRE2。

来源: README.md459-472

使用 MUSL 构建静态二进制文件 (Linux)

对于完全静态的 Linux 二进制文件，您可以使用 MUSL 目标进行构建

要使用 MUSL 和 PCRE2 构建静态可执行文件，您需要安装 musl-gcc。

来源: README.md474-487 ci/utils.sh58-63

按平台划分的安装比较

下表总结了按平台推荐的安装方法

平台	预编译的二进制文件	包管理器	从源代码构建
Windows	✓ (.zip)	Chocolatey, Scoop, Winget	✓
macOS	✓ (.tar.gz)	Homebrew, MacPorts	✓
Debian/Ubuntu	✓ (.deb)	apt	✓
Arch Linux		pacman	✓
Fedora		dnf	✓
RHEL/CentOS		yum + copr	✓
openSUSE		zypper	✓
Gentoo		emerge	✓
Void Linux		xbps	✓
FreeBSD		pkg	✓
OpenBSD		pkg_add	✓
NetBSD		pkgin	✓
Haiku		pkgman	✓
任何 Linux	✓ (静态二进制文件)		✓ (使用 MUSL 进行静态链接)

Windows 特定注意事项

使用 MSVC 在 Windows 上构建时，ripgrep 会包含一个启用长路径支持的清单文件。这允许 ripgrep 处理比传统 260 个字符限制更长的路径，前提是此功能也在 Windows 注册表中启用。

来源: build.rs6-32

安装组件

来源: Cargo.toml95-115

Cargo 安装

如果您是 Rust 程序员，可以直接使用 Cargo 安装 ripgrep

或者，您可以使用 cargo binstall 直接从 GitHub 安装 ripgrep 二进制文件

请注意，最低支持的 Rust 版本为 1.72.0，安装的二进制文件可能比预期要大，因为它包含调试符号。要减小文件大小，可以对二进制文件运行 strip。

来源: README.md413-431 Cargo.toml27

安装

概述