必须显式加--ldb-sync-mode才能真正调试脚本逻辑和副作用，否则--ldb默认异步模式只运行mock环境，redis.call不触发真实命令、不写数据、不报错。
必须显式加 --ldb-sync-mode 才能真正调试脚本逻辑和副作用，否则 --ldb 默认异步模式只跑 mock 环境，redis.call 不触发真实命令、不写数据、不报错。
为什么 redis-cli --ldb --eval script.lua 没反应或直接退出？
这不是脚本问题，而是调试器没进入交互状态。常见原因包括：
-
redis-server版本低于 6.2：6.2 之前--ldb-sync-mode不可用，r（执行 Redis 命令）等调试指令不可靠 - 漏掉
--ldb-sync-mode：默认--ldb是 fork 子进程的异步模式，脚本一运行完就退出，断点不生效、s（step）无响应 - 脚本里没写
redis.debug()或print()：调试器不会自动输出变量值，不主动打点就看不到中间状态 - 误把
Ctrl+C当成“没反应”而中断：实际已进入调试器等待输入，此时敲help或s才是正确操作
--ldb 和 --ldb-sync-mode 的关键区别
二者根本不是“可选开关”，而是两种完全不同的调试目标：
Redis Skill - 高性能缓存管理
下载
Redis 缓存和数据结构管理技能。通过自然语言操作 Redis，支持 String、Hash、List、Set、ZSet、Stream 等数据结构操作。当用户提到 Redis、缓存、消息队列、会话存储时使用此技能。
-
--ldb（异步）：fork 出隔离进程，所有redis.call返回 mock 值（如ping固定返回"+PONG"），KEYS/ARGV 修改、键写入、错误堆栈全被截断——只适合验证纯 Lua 控制流 -
--ldb-sync-mode（同步）：阻塞 Redis 实例，所有redis.call走真实网络调用，数据变更可见、错误 message 完整、事务行为可复现——调试一致性、竞态、异常分支时必须用它 - 同步模式下，整个 Redis 实例暂停服务，务必提前通知团队；异步模式无法观测
redis.pcall()失败后的实际 error 内容
调试前必须检查的三件事
避免浪费时间在环境配置上：
- 运行
redis-server --version，确认 ≥ 6.2；低于 3.2 不支持 LDB，3.2–6.1 仅基础功能可用 - 脚本中至少有一处
redis.debug("checking KEYS[1]: ", KEYS[1])或print("argv len:", #ARGV)，否则调试器 session 里一片空白 - 不要依赖本地
init.lua或require：Redis 沙箱不加载工作目录模块，所有逻辑必须硬编码进主脚本，或用loadfile（但受限且不推荐）
VSCode 或本地 Lua 解释器能替代 redis-cli --ldb 吗？
不能。任何脱离 Redis 服务端上下文的执行都无效：
-
lua script.lua会立即报错attempt to call a nil value (global 'redis')，因为redis表是 Redis C 层注入的，标准 Lua 解释器根本没有 - VSCode + Lua 插件只能测字符串拼接、table 遍历等前置逻辑，一旦出现
redis.call("GET", "x")就卡死——这不是配置问题，是架构限制 -
redis.debug()只在 LDB session 中生效，生产环境静默忽略；print()输出到终端 stdout，两者输出位置和触发时机完全不同
真正难的不是启动调试器，而是区分清楚：你要验证的是“Lua 语法是否通”，还是“这个脚本在真实 Redis 上会不会改错 key、漏处理异常、破坏原子性”。前者用异步模式快速过，后者必须切同步模式，且得盯着 redis.debug() 输出和实际 DB 状态。漏掉这个判断，调试就只是在看幻灯片。
