VSCode 本身不提供 Node.js 运行时或 Redis 连接能力，所谓“配置 Node 环境并连接 Redis”，本质是在系统层面装好 Node 和 Redis，在 VSCode 中编写、运行、调试能连 Redis 的 JavaScript 脚本——VSCode 只是编辑器和调试器载体。
VSCode 本身不提供 Node.js 运行时或 Redis 连接能力，所谓“配置 Node 环境并连接 Redis”，本质是：在系统层面装好 Node 和 Redis，在 VSCode 中写、运行、调试能连 Redis 的 JavaScript 脚本——VSCode 只是编辑器和调试器载体。
确认本地 Node 和 Redis 已就绪
这是所有后续操作的前提，跳过会直接报错。必须手动验证，不能只看安装记录。
- 终端执行
node -v和npm -v，确保输出版本号（如 v20.15.0）；若报“command not found”，说明 Node 没进系统 PATH，需重装或手动配环境变量 - 执行
redis-cli --version，有输出即表示 redis-cli 可用；再跑redis-cli ping，返回PONG才算服务真在运行 - 如果用 Docker 启 Redis，确认容器已启动且端口映射正确：
docker ps | grep redis，并检查是否暴露了6379端口
VSCode 中用 ioredis 连本地 Redis（推荐）
别用已废弃的 redis 包（v4+ 不再维护），ioredis 支持 modern Node（ESM、Promise、自动重连），也兼容 redis:// URL 格式，出错信息更明确。
minimax-mcp-docker版（适配极空间）
下载
MiniMax 图片理解 + 网络搜索 MCP 工具。适配 Docker 环境（极空间等），支持图片 OCR 识别、图像内容理解、网络搜索。API Key 安全存储在本地 credentials 文件，不暴露在代码中。
- 项目根目录运行：
npm init -y && npm install ioredis - 新建
test-redis.js，内容如下：
const Redis = require('ioredis');
const redis = new Redis({
host: '127.0.0.1',
port: 6379,
password: '', // 无密码留空；如有，填字符串，不要用 auth() 方法
enableReadyCheck: true, // 推荐开启，避免 connect 后立刻发命令失败
});
<p>redis.on('connect', () => console.log('✅ Connected'));
redis.on('error', (err) => console.error('❌ Redis error:', err));</p><p>// 测试读写
async function run() {
try {
await redis.set('vscode:test', 'hello from ioredis');
const val = await redis.get('vscode:test');
console.log('Got:', val);
} catch (e) {
console.error(e);
} finally {
await redis.quit();
}
}
run();
- 在 VSCode 中按
F5启动调试，或终端运行node test-redis.js - 常见失败原因：
protected-mode yes（Redis 默认开启，拒绝非本地 IP 连接）、防火墙拦截、bind配置绑定了127.0.0.1却误用localhost（IPv6 解析可能失败）
Redis Explorer 插件只能辅助浏览，不能替代脚本
插件（如 Redis Explorer）只是调用你本地的 redis-cli，它不实现 Redis 协议，也不参与你的代码逻辑。它适合快速查 key，但不适合验证业务缓存行为。
- 必须提前让
redis-cli在终端可用，否则插件点“Connect”直接失败 - 配置文件
.vscode/redis-explorer.json只支持基础字段：host、port、password、name；不支持 ACL 用户名、TLS、Sentinel 或 Cluster - 执行
KEYS *或大 hash 的HGETALL会卡死插件 UI，生产环境禁用这类命令 - 插件看到的数据，是你脚本写入后“那一刻”的快照；它不会自动刷新，也不反映事务、pipeline 中未提交的状态
调试时注意连接生命周期和错误捕获
Node 脚本里连 Redis 最容易忽略的是错误传播和资源释放。一个没 catch 的 redis.set() 拒绝，可能让整个进程静默退出。
- 始终监听
redis.on('error')，否则网络抖动或认证失败时无提示 - 不要在
client.quit()前就process.exit()，否则连接不释放，Redis 侧可能堆积CLIENT LIST中的 idle 连接 - 开发阶段建议加
retry_strategy，比如断连后每 1s 重试一次，避免改完代码热重载时反复报错：
const redis = new Redis({
host: '127.0.0.1',
port: 6379,
retry_strategy: (times) => Math.min(times * 50, 2000), // 最长等 2s
});
真正难的不是“连上”，而是连上之后怎么稳住、怎么测准、怎么不被 protected-mode 或 IPv6 解析坑两次——这些细节不在插件文档里，得靠终端里多敲几遍 redis-cli -h 127.0.0.1 -p 6379 ping 来确认。
