Mac 上安装 Redis 完整教程（两种方法，2026 适配 Apple Silicon / Intel）

Redis 是一个开源的高性能键值对存储系统，常被用作缓存、消息队列、排行榜和实时数据处理。2025 年 5 月发布的 Redis 8.0 重新加入了 OSI 认可的 AGPLv3 开源许可选项，普通开发者在本地学习、测试或用于项目都不会受到限制。本文介绍在 Mac 上安装 Redis 的两种常用方法：通过 Homebrew 一键安装，以及从官方源码编译安装。当前 Mac 几乎全是 Apple Silicon（M1/M2/M3/M4 及后续芯片），因此教程会同时给出 Apple Silicon 与 Intel Mac 的路径差异，照着复制粘贴即可。如果你只是想快速用起来，推荐直接看方法一；想学习源码或锁定某个版本，则跳到方法二。

安装前：先确认你的 Mac 芯片架构

Homebrew 在 Apple Silicon 和 Intel Mac 上的默认安装路径不同，决定了 Redis 配置文件、二进制文件以及 redis-server 命令的完整路径。安装前先用下面命令看一眼架构，再对号入座：

• Apple Silicon（M 系列）：arm64
• Intel 处理器：x86_64

判断方法很简单，在终端运行 uname -m 即可。Apple Silicon 的 Homebrew 装在 /opt/homebrew，Intel 的 Homebrew 装在 /usr/local。后面所有路径差异都会围绕这两个前缀展开。

方法一：通过 Homebrew 安装 Redis

Homebrew 是 macOS 上最常用的包管理器，也是安装 Redis 最简单的方式。它会自动下载依赖、写入 plist 服务文件，并随系统一起维护更新。

1. 安装 Homebrew

如果你的 Mac 还没有安装 Homebrew，在终端执行下面命令：

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

Apple Silicon 安装完成后会提示你把 /opt/homebrew/bin 加入 PATH，按提示操作即可。Intel Mac 的 Homebrew 会自动写到 /usr/local/bin。

2. 安装 Redis

装好 Homebrew 后，直接安装 Redis：

brew install redis

这条命令会拉取当前 Homebrew 仓库里的 Redis 版本（通常是 8.x），并把 redis-server、redis-cli 等二进制放到你的 PATH 中。

3. 让 Redis 开机自启

推荐用 Homebrew 的服务管理让 Redis 随系统启动：

brew services start redis

如果你只是临时测试，不想开机自启，可以前台启动：

redis-server

4. 验证是否安装成功

打开 Redis 客户端，给服务器发一个 ping：

redis-cli ping

如果返回 PONG，说明 Redis 已经在本机跑起来了。

方法二：从源码编译安装 Redis

如果你想学习 Redis 内部实现、测试最新分支，或者希望完全控制编译选项，可以选择从源码编译。手动编译默认会把二进制安装到 /usr/local/bin，与 Homebrew 路径互不冲突。

1. 拉取官方源码

Redis 源码托管在 GitHub，直接克隆当前主分支即可：

git clone --depth 1 https://github.com/redis/redis.git

2. 编译与测试

进入源码目录并编译：

cd redis
make

编译完成后，建议跑一遍测试确认没有环境问题：

make test

这个过程可能需要几分钟，取决于你的 Mac 性能。

3. 安装到系统

编译测试通过后，安装到系统目录：

sudo make install

然后就可以直接启动：

redis-server

4. 验证

同样用 Redis 客户端测试：

redis-cli ping

返回 PONG 即表示编译安装成功。

两种方法怎么选

两种方式都能把 Redis 跑起来，但适用场景略有不同。对大多数用户来说，Homebrew 安装省时省力，还能通过 brew upgrade redis 自动更新到新版；源码编译则适合需要裁剪功能、测试未发布分支或想深入理解 Redis 构建过程的开发者。下面是一个简单对照，方便你根据需求决定。

无论选哪一种，最后都用 redis-cli ping 验证，收到 PONG 才算成功。

安装后：配置文件与常用命令

配置文件在哪里

Homebrew 安装的 Redis 配置文件位置随芯片架构变化：

• Apple Silicon：/opt/homebrew/etc/redis.conf
• Intel Mac：/usr/local/etc/redis.conf

如果你想用自定义配置文件启动 Redis，可以用完整路径：

redis-server /opt/homebrew/etc/redis.conf

启动、停止与重启

• 开机自启管理：brew services start redis / brew services stop redis / brew services restart redis
• 前台运行：redis-server，按 Ctrl+C 停止
• 通过客户端关闭：redis-cli shutdown

默认连接信息

Redis 默认监听 127.0.0.1:6379，没有初始密码。你可以用 redis-cli 进入交互模式，或执行单条命令，例如 redis-cli set foo bar。

常见问题

运行 redis-server 提示 command not found 怎么办？

Apple Silicon 上如果 Homebrew 没有正确加进 PATH，会找不到 /opt/homebrew/bin/redis-server。编辑 ~/.zprofile（或 ~/.zshrc），加上：

eval "$(/opt/homebrew/bin/brew shellenv)"

保存后运行 source ~/.zprofile 即可。手动编译安装的 Redis 会放在 /usr/local/bin，一般默认 PATH 已包含，如果找不到可以检查 echo $PATH 输出。

如何卸载 Redis？

Homebrew 安装的用 brew uninstall redis 并停掉服务 brew services stop redis；源码编译安装的可以用 cd redis && sudo make uninstall，或者直接删除 /usr/local/bin/redis-* 相关文件。

Redis 8 的许可证还能商用吗？

Redis 8.0 提供了 AGPLv3 选项，符合 OSI 开源定义，个人开发、学习、内部使用不受影响。如果你打算把 Redis 作为网络服务对外商用并修改源码，需要遵守 AGPLv3 的公开源代码义务。普通用户按本文安装使用无需担心。

小结

本文介绍了在 Mac 上安装 Redis 的两种方法：Homebrew 适合绝大多数用户，省时省力且能自动更新；源码编译适合想深度定制或研究源码的开发者。当前 Mac 以 Apple Silicon 为主，Homebrew 路径已变为 /opt/homebrew，配置文件也对应到 /opt/homebrew/etc/redis.conf，这是与早期 Intel 教程最大的不同。无论选哪种方式，最后用 redis-cli ping 收到 PONG，就说明 Redis 已经在你的 Mac 上跑起来了。