redis插件连不上connection refused，主因是本地未运行redis服务或配置地址/端口不匹配；需用redis-cli ping验证、检查bind/port、密码url编码，并优先使用scan而非keys。
Redis插件装了但连不上，Connection refused 是最常见的假警报
VSCode 本身不内置 Redis 客户端能力，所谓“Redis 插件”其实是第三方扩展（比如 Redis Client 或 vscode-redis），它们只负责发命令、画界面，**不启动 Redis 服务，也不代理连接**。你看到的 Connection refused，99% 是因为本地根本没跑 Redis，或者它监听的地址/端口和插件填的对不上。
实操建议：
- 先在终端运行
redis-cli ping，如果返回PONG，说明 Redis 在跑；否则用redis-server启动（macOS/Linux 常用brew services start redis） - 检查 Redis 配置：默认只监听
127.0.0.1:6379，如果你填的是localhost却配了bind 127.0.0.1 ::1，没问题；但若填了0.0.0.0或外网 IP，而配置里没放开 bind，就会连不上 - 插件里填的 host 和 port 必须和
redis.conf中的bind+port严格一致；密码字段只填requirepass的值，别带auth命令
用 Redis Client 插件查看键值对，SCAN 比 KEYS * 安全得多
插件界面上点“Refresh”或按 F5，背后实际执行的是 SCAN 命令——这是对的。很多人手动输 KEYS * 想看全量 key，但在生产环境这会阻塞 Redis 主线程，尤其 key 数过万时，直接拖垮服务。
实操建议：
- 插件默认用
SCAN+ 游标分页加载，安全；如需手动查，也请用SCAN 0 MATCH user:* COUNT 100，别碰KEYS - 注意插件的“Pattern”输入框等价于
SCAN的MATCH参数，支持*和?，但不支持正则 - 如果 key 太多导致列表卡顿，不是插件问题，是 Redis 响应慢——可调大插件设置里的
scanCount（比如从 10 改成 100），减少往返次数
编辑字符串值失败？SET 成功但插件显示没变，多半是缓存未刷新或类型不匹配
插件里双击 value 编辑后点保存，底层发的是 SET，但有时改完界面上还是旧值。这不是 bug，而是三个常见原因叠加的结果：插件没自动重载、key 类型不是 string、或你正在看的不是最新 DB。
实操建议：
- 编辑后务必手动点右上角
Refresh图标（或 F5），插件不会监听服务端变更，纯靠轮询/手动触发 - 如果 key 是
hash/list/set类型，插件可能禁止直接编辑 value——先用TYPE keyname确认类型，再用对应命令操作（比如HSET） - VSCode 插件默认连的是 DB 0，如果你用
SELECT 2切过库，插件仍连 DB 0，得在插件连接配置里显式填dbIndex: 2
JSON 值显示乱码或解析失败，redis-cli 和插件对二进制处理不一致
Redis 本身不区分字符串和 JSON，所有 value 都是字节数组。插件尝试用 UTF-8 解码并 JSON.parse，但如果你存的是 gzip 压缩过的 JSON、或含不可见控制字符（比如 \x00）、或用了其他编码（如 GBK），插件就显示 Invalid JSON 或一堆 。
实操建议：
- 确认数据写入方式：用
redis-cli --raw get keyname | hexdump -C看原始字节，比插件显示更真实 - 插件设置里有
showRawValue开关，打开后跳过 JSON 解析，直接显示十六进制或 base64，适合调试非文本内容 - 真正要存 JSON，推荐用 Redis 7.0+ 的
JSON.SET命令和RedisJson扩展，而不是塞进 string 类型——插件对ReJSON的支持更完整
最常被忽略的一点：插件连接配置里的 password 字段，如果密码含 @、/、: 这类 URL 特殊字符，必须 URL encode，否则插件解析连接串时直接截断——比如密码是 pa@ss/word，得填成 pa%40ss%2Fword。
