Redis Insight 汉化教程：Windows / macOS / Linux 设置中文界面（附繁體、教程汉化、关闭自动更新）
本文适用于 Redis Insight 桌面端 3.x（2026 年 11 月测试的最新版为 3.8.0）。
使用的工具：开源项目 redis-insight-chinese（MIT 协议，免费）。
原创声明：本文作者就是该项目的作者（GitHub：hlmd）。文中部分说明和项目 README 一致，因为都出自本人之手。本工具不包含、也不分发 Redis Insight 的任何源码或安装包，与 Redis Ltd. 无关。
一、先说明
- Redis Insight 官方没有中文界面。3.8.0 的源码里只有英文和保加利亚语两份语言包，「语言」设置项被开发者开关隐藏，普通用户看不到；
- 直接改安装包里 JS 字符串的汉化方式很容易误伤代码（比如把
startsWith改成starts使用），而且每次升级都要重做； - 本文的方法不改 Redis Insight 原有代码，而是在
app.asar里加几个运行时钩子，改之前自动备份，可以一键还原。
汉化范围：
| 部分 | 内容 |
|---|---|
| 页面文字 | 按钮、标题、提示、表格、弹窗等，2200+ 条 |
| 菜单 / 对话框 | 顶部菜单栏、托盘菜单、右键菜单、确认框，保留 关闭(C) 式快捷键 |
| 内置教程 | 目录树与正文，代码块里的 // 注释也翻；命令照常能运行 |
| 优化建议 | 数据库分析页的建议（Tips）、创建数据库入口等 |
| 命令助手 | 700+ 条命令简介与复杂度说明 |
Redis 命令与参数、数据类型名（Hash、List、Sorted Set、Stream、JSON、Time Series......）、产品名（Redis Cloud、RDI......）刻意保留英文，方便对照官方文档。
二、Windows 汉化步骤
方法 1：下载 exe（推荐，不用装任何环境）
- 打开 https://github.com/hlmd/redis-insight-chinese/releases ，下载
redis-insight-chinese-win-x64.zip； - 解压，得到
redis-insight-chinese-win-x64.exe； - 完全退出 Redis Insight，右下角托盘图标也要右键退出；
- 运行 exe，终端里打印出「本地化报告」并显示「已写入」即成功；
- 重新打开 Redis Insight，界面变成中文。
Redis Insight 装在
C:\Program Files下时，需要用管理员身份运行。默认的用户级安装（%LOCALAPPDATA%\Programs\Redis Insight）不需要。
方法 2：Scoop 安装
powershell
scoop bucket add hlmd https://github.com/hlmd/scoop-bucket
scoop install hlmd/redis-insight-chinese
redis-insight-chinese方法 3：npm（已装 Node 22.12+）
bash
npx redis-insight-chinese三、macOS 汉化步骤
bash
# Homebrew 安装
brew install hlmd/tap/redis-insight-chinese
# 先完全退出 Redis Insight（Cmd+Q），再运行
redis-insight-chinese也可以在 Release 下载 redis-insight-chinese-macos-arm64.tar.xz（M 系列芯片）或 redis-insight-chinese-macos-x64.tar.xz（Intel），解压后运行：
bash
tar -xf redis-insight-chinese-macos-arm64.tar.xz
chmod +x redis-insight-chinese-macos-arm64 # 解压后丢失执行权限时
./redis-insight-chinese-macos-arm64Redis Insight 装在 /Applications 下，写入时如果提示权限不足，用 sudo 运行。
四、Linux 汉化步骤
bash
# Homebrew（Linuxbrew）
brew install hlmd/tap/redis-insight-chinese
sudo "$(which redis-insight-chinese)"
# 或者下载二进制（arm64 机器换成 linux-arm64）
tar -xf redis-insight-chinese-linux-x64.tar.xz
sudo ./redis-insight-chinese-linux-x64程序会自动查找 /opt/Redis Insight、/opt/RedisInsight、/usr/lib/redisinsight。装在别处的，用 --install <安装目录> 指定。这些都是系统目录，所以要用 sudo。
五、内置教程也是中文
Explore 面板里的 Redis tutorials（向量搜索、JSON、Stream、地理空间查询等）也一起汉化了，包括目录树、正文和代码块里的注释。点「运行」按钮时，Workbench 会先把 // 注释剥掉再执行，所以命令照常能跑。
教程是 Redis Insight 运行时从网上下载的，远端教程更新后，没改动的段落继续显示中文，不需要重新注入 。
六、切换简体 / 繁體 / 英文
不加参数时，程序按系统语言自动选择：系统是 zh-TW、zh-HK 这类繁体地区就用繁體中文，其他情况用简体中文。也可以手动指定：
bash
redis-insight-chinese --lang zh-TW # 繁體中文
redis-insight-chinese --lang zh-CN # 简体中文
redis-insight-chinese restore # 还原英文原版每次注入都会从备份重新生成，所以简繁之间可以随意来回切换。
七、Redis Insight 更新后又变回英文怎么办？
Redis Insight 内置自动更新：启动时以及之后每 84 小时检查一次，有新版就后台下载、退出时自动安装 。安装会整包替换 resources/app.asar，汉化随之消失。有两种处理方式：
方式一：重新运行一次汉化程序。 程序会先把自己和译文更新到最新再注入。
方式二：关闭自动更新。 注入时加一个参数：
bash
redis-insight-chinese --no-app-update这个参数只影响汉化后的这份安装，不改系统环境变量、不改 hosts。想恢复自动更新，不加这个参数重新注入一次即可。
不想改安装包的话，也可以手动设置环境变量，让 Redis Insight 去一个不可达的地址检查更新（Windows）：
powershell
setx RI_MANUAL_UPGRADES_LINK http://127.0.0.1:9/设置后要完全退出再重新打开 Redis Insight。macOS / Linux 的做法见：https://github.com/hlmd/redis-insight-chinese/blob/main/docs/disable-auto-update.md
不建议用 hosts 屏蔽：Redis Insight 的更新包放在
s3.amazonaws.com这类公共域名上，屏蔽会连带影响其他网站和服务。
八、常见问题
| 问题 | 解决办法 |
|---|---|
| 运行后界面还是英文 | 注入前没有完全退出 Redis Insight（含托盘图标）；或者装了多份，用 --install <安装目录> 指定正在用的那份 |
报 EBUSY / EPERM，app.asar 被占用 |
Redis Insight 还在运行，或者系统目录需要管理员权限。退出后重试，macOS / Linux 用 sudo |
| 杀毒软件报毒 / SmartScreen 拦截 | 单文件打包器的启发式误报。可以核对 Release 里的 SHA256SUMS.txt，或者用 npx redis-insight-chinese 运行 |
| 想卸载汉化 | 运行 redis-insight-chinese restore |
| 查看是否注入过 | 运行 redis-insight-chinese verify，备份存在说明至少注入过一次 |
| 某处没翻译 / 翻译不当 | 附截图提 Issue，说明在哪个界面 |
npx 运行报错 |
先用 node -v 确认版本在 22.12 以上，版本太低就升级 Node，或者直接用 Release 里的二进制 |
九、相关链接
- GitHub：https://github.com/hlmd/redis-insight-chinese
- Redis Insight 官方下载：https://redis.io/insight/
本工具为非官方项目，与 Redis Ltd. 无关，仅供个人本地使用。"Redis" 与 "Redis Insight" 是 Redis Ltd. 的商标。
Insight 官方下载：https://redis.io/insight/
本工具为非官方项目，与 Redis Ltd. 无关，仅供个人本地使用。"Redis" 与 "Redis Insight" 是 Redis Ltd. 的商标。