连不上远程 Redis 99% 是服务端配置问题，需先确保 redis-cli 能直连：检查 redis-cli 是否安装、连接是否被拒绝或超时、密码是否需 URL 编码，并确认 redis.conf 中 bind 和 protected-mode 配置正确，最后手动填写插件配置并刷新。

连不上远程 Redis，99% 是服务端没配好，不是 VSCode 插件的问题。 插件只是调用你本地的 redis-cli 去发命令，它不代理、不转发、不改配置——先让 redis-cli -h your-host -p 6379 -a your-pass ping 在终端里返回 PONG，再折腾插件。

确认 redis-cli 能直连远程服务器

插件所有操作都依赖 redis-cli 的底层能力。如果它连不通，插件必然失败。

• 在 VSCode 集成终端中运行：redis-cli -h 192.168.1.100 -p 6379 -a mypass ping（把 IP、端口、密码换成你的真实值）
• 若报 command not found：说明 redis-cli 没装或不在 PATH 中；macOS 用 brew install redis，Linux 用 sudo apt install redis-tools，Windows 下载官方 ZIP 并把含 redis-cli.exe 的目录加进系统 PATH
• 若报 Connection refused 或超时：Redis 服务根本没运行，或防火墙/安全组拦了端口（6379 默认需开放）
• 若报 NOAUTH Authentication required：密码字段填错了——插件里填的是原始密码，但如果你的密码含 @、/、: 等字符，必须 URL 编码，比如 mypass@123 得写成 mypass%40123

检查 redis.conf 的 bind 和 protected-mode

远程连接失败，绝大多数卡在这两个配置上。

Redis Skill - 高性能缓存管理

Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。

下载

• bind 行必须包含你连接所用的 IP：比如你在插件里填 "host": "192.168.1.100"，那 redis.conf 里就得有 bind 192.168.1.100 或 bind 0.0.0.0；只写 bind 127.0.0.1 就只能本机连
• protected-mode yes 时，Redis 会拒绝所有非本地、无密码的连接——哪怕你填对了密码，只要 client IP 不在 bind 列表里，也会被拒；远程场景下必须设为 protected-mode no（仅限开发环境）或确保密码+bind 同时生效
• 改完配置记得重启 Redis：sudo systemctl restart redis（Linux）或 brew services restart redis（macOS）

插件配置里别信“自动识别”，手动填全字段

插件不解析 redis:// URL，也不支持 ACL 用户名（比如 AUTH default mypass 不行），只认明文密码和显式字段。

• 用 Redis Explorer 或 Redis Client 插件，在配置中明确填：

  {
    "host": "192.168.1.100",
    "port": 6379,
    "password": "mypass%40123",
    "dbIndex": 0
  }

• password 字段不能为空字符串，也不能留空——没密码就填 ""，否则会静默认证失败
• 如果你代码里用了 SELECT 2，插件也得配 "dbIndex": 2，否则看到的 key 根本不是你写的那个库
• 别输 KEYS *：插件界面上点 Refresh 是安全的（背后走 SCAN），但手动输这个命令会阻塞 Redis 主线程，key 数过万就可能拖垮服务

大量 key 加载慢？不是插件卡，是 SCAN 分页太细

列表空白、卡顿、半天不出数据，大概率是默认 scanCount: 10 导致游标往返次数太多，而不是插件性能差。

• 打开 VSCode 设置 → Extensions → Redis Explorer → 找到 scanCount
• 从默认 10 改成 100 或 500（注意别超过 Redis 的 maxmemory 压力）
• 改完无需重启，新连接自动生效；已有连接需先 Disconnect 再 Connect
• 想查 user:* 下的 key？直接在 Pattern 输入框输 user:*，不是 KEYS user:*——后者插件根本不认，会报 ERR unknown command 'KEYS'

最常被忽略的一点：插件从不自动刷新。你代码里刚 SET cache:user:1001 "ok"，VSCode 侧边栏不会立刻显示——必须手动点右上角 Refresh 图标，或按 F5。它不监听、不轮询、不长连接，纯靠你触发。