VSCode连接Redis失败主因是redis-cli缺失、host配置错误、protected-mode拦截或Docker网络不通。需验证redis-cli在PATH中，host统一用127.0.0.1（避免IPv6解析歧义），Docker场景改用host.docker.internal或网关IP，并根据环境关闭protected-mode或设置密码。
VSCode 本身不连接 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 填 localhost 就连不上？
IPv6 环境下，localhost 默认解析为 ::1，而 Redis 默认只监听 127.0.0.1（IPv4）。配置写 "host": "localhost"，实际请求发向 ::1，结果就是 Connection refused。
- 统一改用
"host": "127.0.0.1"，彻底避开 DNS 解析歧义 - 如果 Redis 确实监听了
::1（比如手动改过bind配置），那也要确保redis.conf中同时包含127.0.0.1和::1 - Docker 场景下，宿主机连容器 Redis 时，
host不能填localhost或127.0.0.1，得填容器网关 IP（如172.17.0.1）或使用host.docker.internal（仅限 Docker Desktop）
protected-mode 启用但没设密码，连接会被拒绝
Redis 6.0+ 默认开启 protected-mode yes，此时若未配置 requirepass 且 bind 不含 127.0.0.1，任何外部连接（包括 redis-cli）都会被拒绝，错误类似：DENIED Redis is running in protected mode...
- 临时解决：编辑
redis.conf，设protected-mode no（仅限开发环境） - 推荐做法：保留
protected-mode yes，并设置密码：requirepass your_password，然后在插件连接配置中填入该密码 - 注意：密码为空字符串时，插件可能忽略认证字段，导致连接失败；留空或明确填
""都不如直接删掉密码字段来得可靠
插件选型与连接配置细节
目前最稳定、维护活跃的是 Redis Explorer（作者 Shyam Seshadri），它不依赖 Node.js 运行时，纯靠调用 redis-cli，兼容性好、出错路径清晰。
- 连接配置中
DB Index默认是0，填其他数字（如1）会切换到对应 DB，但插件不会自动列出所有 DB，需手动指定 - SSL/TLS 连接需要插件显式支持（如
Redis Client），Redis Explorer当前不支持；若服务端强制 SSL，只能换插件或改用redis-cli --tls手动测试 - 连接名（
Name）建议带环境标识，例如dev-redis-6379，避免多个实例混淆
真正卡住人的从来不是“怎么点连接按钮”，而是 redis-cli 调用链上哪一环断了——PATH、host、protected-mode、Docker 网络，四个点漏查一个，就白配十分钟。
