在 macOS 上安装 Percona Toolkit

在 macOS 上安装 Percona Toolkit 有两条主要路径：Homebrew（推荐） 与 源码编译。Homebrew 提供了官方的 formula，会自动处理 Perl 与 DBD::mysql 等依赖，Apple Silicon 与 Intel 两种架构均有预编译 bottle。

方式一：通过 Homebrew 安装（推荐）

1. 确认已安装 Homebrew

如尚未安装 Homebrew，在终端执行官方安装脚本：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装完成后按提示把 brew 加入 PATH（Apple Silicon 通常已自动配置到 /opt/homebrew）。

2. 安装 Percona Toolkit

brew install percona-toolkit

该命令会拉取最新的稳定版，并自动安装其依赖 perl-dbd-mysql（MySQL 的 Perl DBI 驱动）。Apple Silicon（arm64）与 Intel（x86_64）macOS 均有预编译 bottle，通常无需本地编译。

3. 验证

pt-summary --version

查看已安装信息与版本：

brew info percona-toolkit

方式二：从源码编译安装

当 Homebrew 不可用、或需要特定版本/自定义编译时，可从官方 tar.gz 源码包编译。

1. 准备依赖

需要 Perl 解释器（macOS 自带，或用 brew install perl 获得较新版本）以及 DBI、DBD::mysql 模块：

brew install mysql-client
cpan install DBI DBD::mysql

若使用系统自带 Perl，请用 sudo cpan install DBI DBD::mysql；用 Homebrew 的 Perl 则不需要 sudo。

2. 下载并编译安装

wget https://downloads.percona.com/downloads/percona-toolkit/3.5.1/source/tarball/percona-toolkit-3.5.1.tar.gz
tar -xzf percona-toolkit-3.5.1.tar.gz
cd percona-toolkit-3.5.1
perl Makefile.PL
make
sudo make install

注意

从 tar.gz 源码包直接运行工具时，每个运行实例都会生成随机 UUID（详见 安装概述 - 实例 UUID）。希望获得稳定实例标识时，优先使用 Homebrew 或包安装。

验证安装

pt-query-digest --version
ls /opt/homebrew/bin/pt-*     # Apple Silicon 的 Homebrew 路径
# 或 ls /usr/local/bin/pt-*  # Intel 的 Homebrew 路径

注意事项

• Percona Toolkit 是命令行工具，没有图形界面；所有操作在终端完成。
• 部分工具依赖 Perl 模块（如 DBI、DBD::mysql），Homebrew 安装会自动带上 perl-dbd-mysql；源码编译需自行安装。
• 连接本机或远程 MySQL/MongoDB/PostgreSQL 时，按对应工具的要求提供 -h、-u、-p 等连接选项即可，与 Linux 下用法完全一致。

更多细节请阅读 官方文档。