Redis 是目前最主流的高性能内存数据库，广泛用于缓存、限流、分布式锁、会话存储等开发场景。很多Mac开发新手在本地部署Redis时，会遇到安装失败、命令找不到、端口占用、不会查看版本等问题。
本文章，给大家整理一套适配MacBook M系芯片机型的完整实操方案，包含三种安装方式、启停命令、服务管理、版本查询、常见问题解决，全程终端操作，简单零踩坑。
阅读前置：所有操作均在Mac自带「终端」中完成，无需额外安装复杂软件。
一、首选安装方式：Homebrew 安装（最简单、最稳定）
Homebrew是Mac专属包管理工具，通过它安装Redis可自动配置环境变量、注册系统服务，支持开机自启，是本地开发的最优选择。
1. 检查/安装 Homebrew
首先打开终端，执行以下命令检查是否已安装Homebrew：
brew -v
若提示 command not found，说明未安装，执行官方一键安装命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
具体的 Homebrew 安装查看这篇文章：
MacBook M 系列芯片一键国内镜像安装 Homebrew 完整踩坑实录（清华源安装本体 + 阿里 bottles 源）_brew 镜像都不行了-CSDN博客
2. 安装 Redis
Homebrew准备完成后，直接执行安装命令，自动安装最新稳定版Redis：
brew install redis
# 查看是否安装完成
brew list
3. 启动 Redis 服务
提供两种启动方式，根据开发需求选择：
✅ 方式1：后台常驻启动（推荐，开机自启）
安装系统服务，后台静默运行，关闭终端不停止，适合长期开发使用：
brew services start redis
✅ 方式2：临时前台启动（测试用）
仅临时运行，关闭终端窗口服务就会停止，适合临时测试：
redis-server
4. 验证 Redis 是否安装成功
新开一个终端窗口，执行连通性测试命令：
redis-cli ping
✅ 结果解读
执行命令：redis-cli ping 返回：PONG 代表 Redis 服务正常运行，客户端可以成功连通本地 Redis。
5. Redis 常用服务管理命令
统一整理日常开发高频使用的启停、查看命令：
brew services start redis # 启动服务（开机自启）
brew services stop redis # 停止服务
brew services restart redis # 重启服务
brew services info redis # 查看服务运行状态
redis-cli # 进入Redis客户端命令行
6. Redis 配置文件位置
不同机型配置文件路径不同，修改密码、端口、远程连接等配置需找到对应文件：
-
Apple Silicon（M系列芯片）：
/opt/homebrew/etc/redis.conf -
Intel 芯片 Mac：
/usr/local/etc/redis.conf
二、轻量化安装：Docker 运行 Redis（不污染本地环境）
如果不想在本地安装软件、担心环境冲突，推荐使用Docker容器运行Redis，即开即用、卸载无残留。前提是电脑已安装Docker。
一键拉取镜像并启动Redis（默认映射6379默认端口）：
docker run -d --name redis -p 6379:6379 redis:latest
进入Redis客户端命令行：
docker exec -it redis redis-cli
三、进阶安装：源码编译安装（适合高阶需求）
适合需要指定Redis固定版本、自定义编译配置的开发者，新手不推荐。全程需要Xcode编译工具支持。
# 安装编译依赖工具
xcode-select --install
# 下载官方源码包
curl -O https://download.redis.io/redis-stable.tar.gz
# 解压并进入目录
tar -zxvf redis-stable.tar.gz
cd redis-stable
# 编译安装
make
sudo make install
# 启动服务
redis-server
四、Redis 版本查看三种方法（精准区分客户端/服务端）
很多新手分不清客户端和服务端版本，这里整理三种通用查询方式，适配本地安装和Docker安装。
1. 查看 Redis 客户端版本（最常用）
redis-cli --version
# 简写命令
redis-cli -v
输出示例：redis-cli 7.2.4
2. 查看 Redis 服务端版本（精准）
先进入Redis客户端，再查询服务端详细信息：
redis-cli
# 执行查询命令
INFO server
在输出内容中找到 redis_version:xxx，即为服务端真实版本。
3. 直接查询服务端版本
redis-server --version
# 简写命令
redis-server -v
4. Docker 环境专属版本查询
# 查看客户端版本
docker exec -it redis redis-cli -v
# 查看服务端版本
docker exec -it redis redis-server -v
小知识点：Homebrew正常安装的Redis，客户端和服务端版本保持一致，无需刻意区分。
五、常见问题避坑解决
1. 6379 端口被占用
启动失败提示端口占用时，查询占用进程并关闭：
# 查询6379端口进程
lsof -i :6379
# 杀死占用进程（替换为查到的进程号）
kill -9 进程号
2. redis-cli: command not found
原因是Homebrew环境变量未生效，解决方案：重启终端，或按照Homebrew安装提示，将环境变量配置写入shell配置文件即可。
3. 彻底卸载 Redis
brew uninstall redis
六、总结
1. 普通开发首选 Homebrew安装，一键部署、自带服务管理、稳定无坑，适配所有Mac机型；
2. 追求环境纯净、多版本切换选 Docker安装，无需污染本地环境；
3. 定制化需求可选择 源码编译安装；
4. 日常查询版本可直接用 redis-cli -v，快速高效。
