vscode本身不实现redis协议，所有连接均依赖插件调用本地redis-cli；连不上主因是redis-cli未安装或path未配置、host填localhost导致ipv6解析失败、protected-mode启用且无密码、docker网络配置不当。
VSCode 本身不连接 Redis——它没实现 Redis 协议，所有“连接成功”都是插件调用你本地的 redis-cli 发起的请求。连不上不是插件坏了，而是 redis-cli 缺失、host 填错、protected-mode 拦截或 Docker 网络不通这四类问题中的某一个。
确认 redis-cli 已安装且在 PATH 中
Redis Explorer（最常用插件）启动时会直接调用 redis-cli --version 和 redis-cli -h 127.0.0.1 -p 6379 ping。如果终端里运行报 command not found，插件必然失败。
- macOS：运行
brew install redis（自动装服务端 + 客户端） - Linux（Ubuntu/Debian）：运行
sudo apt install redis-tools - Windows：下载官方 ZIP 包（如
redis-stable-win64.zip），把含redis-cli.exe的目录加进系统 PATH - 验证方式：在 VSCode 集成终端中运行
which redis-cli（macOS/Linux）或where redis-cli（Windows），必须有输出
填对 host 才能绕过 IPv6 解析陷阱
配置里写 "host": "localhost" 在多数 macOS/Linux 环境下实际走的是 ::1（IPv6），而 Redis 默认只监听 127.0.0.1（IPv4），结果就是 Connection refused。
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
- 统一改用
"host": "127.0.0.1"，彻底避开 DNS 解析歧义 - Docker 容器内 Redis：
– macOS/Windows：填"host": "host.docker.internal"
– Linux：填宿主机真实 IP（如192.168.1.100），不能填localhost或127.0.0.1 - 检查
redis.conf中bind行是否包含你连接所用的地址，例如bind 127.0.0.1 ::1才支持双栈
处理 protected-mode yes 导致的认证拦截
Redis 6+ 默认开启 protected-mode yes，此时若未设 requirepass，又没把 client IP 加进 bind 列表，就会拒绝所有非 127.0.0.1 的连接——哪怕你填的是 localhost，也可能被判定为“非本地”。
- 临时方案：在
redis.conf中设protected-mode no（仅限开发环境） - 安全方案：设密码
requirepass mypass，然后插件配置中填"password": "mypass" - 注意：插件不支持 ACL 用户名（
AUTH default mypass不行），也不解析redis://:mypass@...这类 URL 格式 - 密码字段只接受明文单密码，填错格式会导致“连上但查不到 key”
别信“可视化=自动刷新”，SCAN 才是唯一安全操作
插件界面上点 Refresh，背后发的是 SCAN；但如果你手动输 KEYS *，它真会发——这个命令在 key 数超万时会让 Redis 主线程卡死，VSCode UI 直接无响应。
- 编辑 value 后界面不更新？必须手动点右上角 Refresh 图标（或按
F5），插件不会监听服务端变更 - Pattern 输入框 =
MATCH参数，支持*和?，不支持正则；例如输user:*:profile - 大实例务必用
SCAN 0 MATCH user:* COUNT 500，COUNT调大可减少往返次数 - 值显示为
\x00\x01或空白？大概率用了 Database Client 插件——它不兼容 RESP3、不处理 AUTH、对哈希/列表只显示原始字节流
真正容易被忽略的是：插件从不校验 key 类型。你对着一个 HASH 双击编辑，它默认当 STRING 处理，保存会失败。动手前先在终端跑 TYPE yourkey 确认类型，再决定该用 HSET 还是 SET。
