引言

对于刚接触 Redis 的新手来说，“安装” 往往是第一个拦路虎 —— 选不对版本导致服务频繁崩溃、找错系统适配包导致安装失败、不清楚配置细节导致后续无法启动，这些问题都可能让学习热情大打折扣。其实，只要掌握 “版本选择逻辑 + 系统适配步骤”，Redis 安装就能轻松搞定。本文将从版本挑选讲起，手把手带你完成 Windows、macOS、Linux 三大系统的 Redis 安装，同时避开新手常踩的坑。

一、安装 Redis 前必须明确的核心问题

在动手安装前，先思考两个关键问题：选哪个版本？适配哪个系统？（不仅是安装 Redis 前需要简单思考，其他软件安装前也通用）

很多新手跳过这两步直接下载安装，结果出现 “Windows 版本长期不更新”“Linux 编译报错” 等问题。实际上，Redis 的版本选择直接影响稳定性，系统适配则决定安装能否顺利完成。比如生产环境用了开发版，可能因未修复的 BUG 导致数据丢失；Windows 用了官方未支持的包，会出现服务启动闪退的情况。因此，先理清版本和系统的适配逻辑，是安装成功的第一步。

二、Redis 版本选择：稳定版 vs 开发版，该怎么选？

Redis 的版本命名有明确规则，掌握这个规则，就能快速选出适合自己的版本。

2.1 版本规则：看 “次版本号” 辨稳定性

Redis 版本格式为 “主版本号.次版本号.修订号”（如 6.2.6、7.0.12），其中次版本号是判断稳定性的关键：

• 次版本号为偶数：稳定版（Stable Version），如 5.0、6.2、7.0，经过充分测试，BUG 少、运行稳定，官方推荐用于生产环境和日常学习。

• 次版本号为奇数：开发版（Development Version），如 5.3、6.1、7.1，主要用于测试新功能（如多线程 IO、新数据结构），未经过全面验证，稳定性差，不适合正式场景。

2.2 稳定版与开发版核心差异

为了更直观区分，我们通过表格对比两类版本的关键维度：

对比维度	开发版（非稳定版）	稳定版（Stable Version）
BUG 数量	较多，存在未修复的潜在问题	极少，经过社区长期验证和迭代
稳定性	差，可能出现服务崩溃、数据异常	强，可长期稳定运行，支持高并发
功能完整性	含最新功能，但部分功能可能未完善	功能成熟，仅包含经过验证的特性
适用场景	新功能测试、技术验证、个人研究	生产环境、日常学习、开发测试项目

2.3 版本选择建议

• 优先选稳定版：无论你是学习 Redis 基础，还是搭建开发测试环境，甚至部署生产服务，稳定版都是首选。推荐选择 6.2 或 7.0 版本，这两个版本支持主流核心功能（如 Redis Cluster、Stream 数据结构），且社区文档丰富，遇到问题容易找到解决方案。

• 谨慎选开发版：仅当你需要测试 Redis 最新特性（如 Redis 7.1 的新命令优化），且能接受服务不稳定的风险时，才考虑开发版，且禁止在生产环境使用。

三、多系统安装教程：step-by-step 实操

Redis 对不同操作系统的支持程度不同：Linux 是官方推荐的生产环境系统，macOS 适合开发者本地学习，而 Windows 因官方不直接支持，需特殊处理。下面分系统详细讲解安装步骤。但是会重点介绍 Windows 系统下 Redis 的安装，对于初学者而言普遍使用 Windows 系统，可以先用该版本进行初步学习，之后转战其他平台。

3.1 Windows 系统安装（含官方限制说明）

（1）先明确：Windows 没有官方版本

Redis 官方仅提供 Linux/macOS 版本，不支持 Windows 系统。目前 Windows 上能运行的 Redis，是微软在 2016 年前后基于 Redis 3.2 版本编译的修改版，后续未再更新（最新版本为 3.2.100），功能相对老旧（不支持 Redis 5.0+ 的部分新特性）。
如果你的电脑是 Windows，且仅用于学习 Redis 基础（如命令操作、数据结构），可以使用该版本；若需学习集群、Stream 等新特性，建议通过 Docker 安装或改用 Linux 虚拟机。

（2）下载路径

微软编译的 Redis 版本归档在 GitHub 仓库，下载地址：https://github.com/microsoftarchive/redis/releases
进入页面后，拉到 “Assets” 部分，有两种安装包可选：

• .msi 安装版：带图形化安装向导，适合新手，会自动配置部分环境变量。

• .zip 解压版：无需安装，解压后即可使用，但需手动配置环境变量。

这里以新手友好的 .msi 安装版（Redis-x64-3.2.100.msi） 为例，讲解安装步骤。

（3）详细安装步骤

1. 启动安装向导：双击下载的 Redis-x64-3.2.100.msi 文件，弹出 “Redis on Windows Setup” 欢迎界面，点击 “Next”。
   

2. 同意许可协议：勾选 “I accept the terms in the License Agreement”，点击 “Next”。
   

3. 选择安装路径与环境变量：

   • 建议修改安装路径：默认安装在 C 盘，为避免后续权限问题，可将路径改为 D 盘（如 D:\Program Files\Redis）。

   • 必须勾选 “Add the Redis installation folder to the PATH environment variable”（将 Redis 路径添加到系统环境变量），这样后续在任意命令行窗口都能调用 Redis 命令，无需切换到安装目录。

   • 点击 “Next”。
     

4. 端口与防火墙设置：

   • 端口默认 6379（Redis 官方约定端口，无需修改，避免与其他服务冲突）。

   • 勾选 “Add an exception to the Windows Firewall”（为 Redis 添加防火墙例外，允许外部连接），点击 “Next”。
     

5. 内存限制设置：默认限制 100MB 内存，学习阶段无需修改，点击 “Next”。

6. 开始安装：点击 “Install”，等待 1-2 秒，安装完成后点击 “Finish”。
   

注意： 安装完成后，在桌面不会产生图标，这是因为当前安装的是 Redis 服务。

（4）安装后目录文件解读

安装完成后，进入 D:\Program Files\Redis 目录：

核心文件功能如下（新手需重点关注前 3 个）：

文件名	功能说明
redis-server.exe	Redis 服务器端主程序，启动 Redis 服务必须运行该文件
redis-cli.exe	Redis 命令行客户端，用于连接 Redis 服务并执行命令（如 SET、GET）
redis.windows-service.conf	服务启动模式的配置文件（作为 Windows 服务运行时加载）
redis.windows.conf	普通启动模式的配置文件（双击 redis-server.exe 时默认加载）
redis-benchmark.exe	Redis 性能测试工具，可模拟多客户端并发请求
redis-check-aof.exe	AOF（Append Only File）持久化文件检查修复工具。
redis-check-rdb.exe	RDB 持久化文件检查修复工具（在部分版本中可能名为 redis-check-dump.exe）。
redis-sentinel.exe	Redis 哨兵（Sentinel）进程，用于管理多个 Redis 服务器，实现高可用性。

3.2 macOS 系统安装（官方推荐，适合开发者）

macOS 是 Redis 官方支持的系统，安装方式简单，推荐用 Homebrew（macOS 包管理工具）安装，步骤如下：

（1）先检查 Homebrew 是否安装

打开 “终端”，执行 brew -v 命令：

• 若显示 Homebrew 4.x.x，说明已安装，直接进入下一步。

• 若提示 “command not found”，需先安装 Homebrew，执行以下命令（需等待几分钟）：

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

（2）安装 Redis

在终端执行以下命令，Homebrew 会自动下载并安装最新稳定版 Redis（如 7.0.12）：

brew install redis

（3）验证安装

安装完成后，执行 redis-server --version 命令，若显示类似 Redis server v=7.0.12 sha=00000000:0 malloc=libc bits=64 build=xxxxxxx 的信息，说明安装成功。

（4）环境配置（可选，提升便捷性）

Homebrew 会自动将 Redis 命令路径（如 /usr/local/bin）添加到系统环境变量，一般无需额外配置。若执行 redis-cli 提示 “命令不存在”，可手动添加环境变量：

1. 终端执行 open ~/.bash_profile（或 ~/.zshrc，取决于你用的 Shell）。

2. 在文件末尾添加：export PATH="/usr/local/bin:$PATH"。

3. 保存文件后，执行 source ~/.bash_profile（或 source ~/.zshrc）使配置生效。

3.3 Linux 系统安装（生产环境首选，以 CentOS 为例）

Linux 是 Redis 官方推荐的生产环境系统，性能最优，支持所有特性。这里以 CentOS 7 为例，讲解两种安装方式：源码安装（适合需要最新版本）和 yum 安装（适合快速部署）。

（1）方式一：yum 安装（快速，适合新手）

yum 是 CentOS 自带的包管理工具，安装步骤简单，但版本可能略旧（一般是 5.0 或 6.2 稳定版）：

1. 终端执行以下命令，安装 Redis：

   sudo yum install redis -y
   

2. 安装完成后，执行 redis --version 验证，显示版本信息即成功。

（2）方式二：源码安装（获取最新稳定版）

若需安装最新稳定版（如 7.2.4），需通过源码编译安装：

1. 安装依赖工具：Redis 用 C 语言开发，需先安装编译工具 gcc：

   sudo yum install gcc -y
   

2. 下载源码包：进入 Redis 官网下载页，复制最新稳定版的源码包链接（如 https://download.redis.io/releases/redis-7.2.4.tar.gz），在终端执行：

   wget https://download.redis.io/releases/redis-7.2.4.tar.gz
   

3. 解压源码包：

   tar -zxvf redis-7.2.4.tar.gz
   

4. 编译与安装：

   cd redis-7.2.4  # 进入解压目录
   make  # 编译（需等待 1-2 分钟，确保 gcc 已安装）
   sudo make install  # 安装到系统目录（默认路径 /usr/local/bin）
   

5. 验证安装：执行 redis-server --version，显示版本信息即成功。

（3）启动 Redis 服务（Linux 通用）

无论哪种安装方式，都可通过以下命令启动 Redis 服务：

# 前台启动（终端关闭则服务停止，适合测试）
redis-server
# 后台启动（生产推荐，需先修改配置文件）
# 1. 找到 redis.conf 配置文件（yum 安装默认在 /etc/redis.conf，源码安装在解压目录）
# 2. 将 daemonize no 改为 daemonize yes（允许后台运行）
# 3. 执行后台启动命令：
redis-server /etc/redis.conf

四、安装避坑指南：新手常踩的 5 个坑及解决方案

安装过程中，新手容易遇到各种问题，这里整理了 5 个高频坑点及解决方法，帮你快速排障。

4.1 坑 1：Windows 安装后双击 redis-server.exe 闪退

原因：Redis 服务已通过 Windows 服务启动（安装时默认自动启动），再次双击启动会因端口冲突闪退。
解决方案：

1. 右键点击 “此电脑”→“管理”→“服务和应用程序”→“服务”。

2. 在服务列表中找到 “Redis”，查看 “状态”：若显示 “正在运行”，右键选择 “停止”。

3. 再次双击 redis-server.exe，即可正常启动（终端窗口显示 Redis 启动信息，不闪退）。

4.2 坑 2：macOS/Linux 执行 redis-cli 提示 “command not found”

原因：Redis 命令路径未添加到系统环境变量，终端无法找到命令。
解决方案：

• macOS：执行 echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.zshrc（或 .bash_profile），再执行 source ~/.zshrc。

• Linux：执行 echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc，再执行 source ~/.bashrc。

• 验证：执行 redis-cli -v，显示版本信息即修复成功。

4.3 坑 3：Linux 源码安装执行 make 报错 “gcc: command not found”

原因：系统未安装 C 语言编译工具 gcc，导致无法编译 Redis 源码。
解决方案：安装 gcc 工具：

• CentOS/RHEL：sudo yum install gcc -y

• Ubuntu/Debian：sudo apt-get install gcc -y
  安装完成后，重新执行 make 即可。

4.4 坑 4：安装路径含中文 / 空格，导致服务启动失败

原因：Redis 对路径中的特殊字符敏感，中文或空格会导致配置文件加载失败。
解决方案：

• 安装时选择纯英文、无空格的路径，如 Windows 选 D:\Program Files\Redis（而非 D:\Redis 安装），Linux/macOS 选 /usr/local/redis。

• 若已安装到错误路径，需卸载后重新安装（Windows 可通过 “控制面板→卸载程序” 卸载，Linux 源码安装需删除 /usr/local/bin 下的 Redis 命令文件）。

4.5 坑 5：未勾选 PATH 环境变量，每次需切换到安装目录执行命令

原因：Windows 安装时未勾选 “Add to PATH”，或 macOS/Linux 未配置环境变量，导致终端无法全局调用 Redis 命令。
解决方案：

• Windows：手动添加环境变量：

  1. 右键 “此电脑”→“属性”→“高级系统设置”→“环境变量”。

  2. 在 “系统变量” 中找到 “Path”，点击 “编辑”→“新建”，添加 Redis 安装路径（如 D:\Program Files\Redis）。

  3. 点击 “确定”，关闭所有终端后重新打开，即可全局执行 redis-cli 命令。

• macOS/Linux：参考 “坑 2” 的解决方案，配置环境变量。

五、总结：安装完成后的下一步

当你能成功执行 redis-cli ping 并收到 PONG 回复时，说明 Redis 已安装并启动成功。接下来，你可以：

1. 学习 Redis 命令行客户端（redis-cli）的使用，比如执行 SET name "redis"、GET name 等基础命令。

2. 了解 Redis 服务的启停方式（如 Windows 服务管理、Linux 后台启动），为后续学习奠定基础。

3. 若需学习新特性（如 Redis Cluster），Windows 用户建议改用 Docker 或 Linux 虚拟机，避免因旧版本受限。

安装是 Redis 学习的第一步，选对版本、避开坑点，才能让后续的学习更顺畅。