redis cli未安装导致vscode插件无法连接，因redis explorer等插件依赖本地redis-cli验证环境；需先通过brew/apt/yum安装并配置path，再重启vscode。
redis-cli 没装，VSCode 插件根本连不上
Redis Explorer 等插件不是独立客户端，它启动时会尝试调用 redis-cli --version 验证本地环境。如果报 command not found，不是插件没配好，是你系统里压根没装 redis-cli 或它不在 $PATH 里。
验证方式很简单：在 VSCode 内置终端里直接执行：redis-cli --version。失败就别折腾插件配置了，先装工具：
- macOS：用
brew install redis（自带redis-cli） - Windows：从 GitHub Release 页面 下载
Redis-x64-*.zip，解压后把目录加进系统PATH - Linux：多数发行版用
sudo apt install redis-tools（Ubuntu/Debian）或sudo yum install redis（CentOS/RHEL）
装完重启 VSCode，再试插件连接——否则所有“连接失败”“空白列表”问题都白调。
Redis Explorer 不支持集群、TLS、Sentinel
你看到的“已连接”，只是插件用 redis-cli -h 127.0.0.1 -p 6379 成功连上了单机实例。一旦 Redis 是集群模式（比如用了 redis-cli -c），插件遇到 MOVED 12345 192.168.1.10:7001 这类重定向响应，会直接断开，不会自动跳转。
同样不支持的还有：
- TLS 加密连接（
redis-cli --tls --cert ...参数插件不透传） - Sentinel 自动故障转移发现（插件只认静态 host:port）
- 带 ACL 用户名的认证（只支持 password 字段，不支持
auth username pass）
如果你的生产 Redis 是集群或启用了 TLS，插件只能当只读浏览器用——查 key 列表、点开看 string/hash 值还行，但不能执行 HGETALL、EXPIRE 等命令，更别提诊断 CLUSTER NODES 了。
.vscode/redis-explorer.json 的路径和字段必须严格匹配
插件读取连接配置的优先级是：.vscode/redis-explorer.json > 全局设置里的 redis.explorer.connections。很多人填错字段名或格式，导致配置不生效。
正确写法（注意字段名大小写、无多余逗号、密码为空时写 null）：
{
"connections": [
{
"name": "local-dev",
"host": "127.0.0.1",
"port": 6379,
"password": null,
"database": 0
}
]
}
常见错误：
- 把
password写成passwd或auth -
database字段写成字符串"0"（必须是数字） - Windows 路径含空格时没用双引号包裹整个 JSON 文件路径（VSCode 启动时会静默忽略）
- 文件放在项目根目录外，或名字拼错成
redis-explorer.json少了个r
想执行任意命令？别依赖插件输入框
插件界面上那个“命令输入框”只支持极少数基础命令（GET、SET、DEL），像 KEYS user:*、HGETALL session:abc、EXPIRE cart:123 3600 这些，要么不识别，要么执行后没反馈。
真正可靠的方案是用 VSCode 的 tasks.json 调用原生 redis-cli：
{
"version": "2.0.0",
"tasks": [
{
"label": "list user keys",
"type": "shell",
"command": "redis-cli -h 127.0.0.1 -p 6379 KEYS \"user:*\"",
"group": "build",
"presentation": {
"echo": true,
"reveal": "always",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": true
}
}
]
}
然后按 Ctrl+Shift+P → 输入 Tasks: Run Task → 选 list user keys。比插件输入框稳定，还能用 shell 变量、管道、重定向。
复杂场景下，插件的“可视化”只是辅助，redis-cli 才是事实标准——别把它当成可有可无的配件，而是开发 Redis 缓存时每天要敲十几次的主力工具。
