VSCode本身不支持直接连接Redis，所有可视化功能均依赖插件（如Redis Explorer）调用本地redis-cli实现；连接失败主因是未安装或PATH未配置redis-cli、host填写错误（如localhost在IPv6下解析为::1）、protected-mode启用且无密码、或Docker网络配置不当。
VSCode 本身不提供 Redis 连接能力，所谓“可视化查看器”全是靠插件桥接本地工具或脚本——你看到的连接成功，其实是 redis-cli 在后台执行命令。没装好 redis-cli、填错 host 或忽略 protected-mode，90% 的连接失败都卡在这几步。
Redis Explorer 插件必须有 redis-cli 才能工作
这个插件（作者 Shyam Seshadri）不是独立客户端，它启动后会调用系统 PATH 下的 redis-cli 发送 PING 和 SCAN。没有它，连图标都点不动。
- 在 VSCode 集成终端运行
redis-cli --version，必须输出类似redis-cli 7.2.5 - macOS：用
brew install redis（会同时装服务端和客户端） - Windows：下完整版 ZIP（如
redis-stable-win64.zip），把redis-cli.exe所在目录加进系统 PATH - Linux：用
sudo apt install redis-tools（Ubuntu/Debian）或sudo yum install redis（CentOS/RHEL） - 验证路径是否生效：在 VSCode 终端里运行
which redis-cli（macOS/Linux）或where redis-cli（Windows），必须有输出
host 填 localhost 很可能连不上
IPv6 环境下，localhost 默认解析为 ::1，而 Redis 默认只监听 127.0.0.1（IPv4）。配置写 "host": "localhost"，redis-cli -h localhost ping 就会超时。
- 统一改用
"host": "127.0.0.1"，绕过 DNS 解析歧义 - Docker 容器内 Redis：macOS/Windows 填
"host": "host.docker.internal"；Linux 填宿主机真实 IP（如192.168.1.100） - 检查
redis.conf中bind行是否包含你连接用的地址，例如bind 127.0.0.1 ::1才支持双栈 -
protected-mode yes且未设密码时，Redis 会拒绝所有非127.0.0.1的连接——要么关掉它（protected-mode no），要么配requirepass
密码字段只认明文单密码，不支持 ACL 或 URL 格式
Redis Explorer 不支持 AUTH <username><password></password></username>，也不解析 redis://:mypass@localhost:6379/0 这类 URL。填错格式会导致“连上了却查不到 key”。
- 配置中只留
"password": "mypass"字段，值为字符串；空密码写"password": ""，不能删掉该字段 - 如果 Redis 启用了 ACL（比如
auth myuser mypass），插件完全无法认证——换用 Node.js 脚本 +ioredis - 配置文件路径优先级：
.vscode/redis-explorer.json> 全局 VSCode 设置；内容必须是合法 JSON，字段名全小写，字符串值必须加双引号 - 示例有效配置：
{"host":"127.0.0.1","port":6379,"password":"mypass","name":"dev-redis"}
编辑 value 失败？不是插件 bug，是没刷新或类型不匹配
插件界面上双击修改后点保存，底层发的是 SET，但显示没变，大概率是你没手动刷新，或 key 根本不是 string 类型。
- 编辑完必须点右上角 Refresh 图标（或按
F5），插件不会自动轮询，也不会监听服务端变更 - 先运行
TYPE keyname确认类型：是hash就得用HSET，是list就得用LPUSH，插件对非 string 类型通常禁止直接编辑 - 插件默认访问 DB 0；如果你用
SELECT 2切过库，得在配置里加"db": 2字段，否则看不到数据 - 大 key 列表卡顿？不是插件性能差，是 SCAN 往返次数太多——在插件设置里调高
scanCount（比如从默认 10 改成 100），减少请求轮次
真正复杂的地方不在配置界面，而在你是否意识到：插件只是外壳，redis-cli 是命脉，而 Redis 本身的网络策略（bind、protected-mode、IPv6 解析）才是决定连不连得上的硬约束。漏掉其中任一环，界面再漂亮也白搭。
