redis-cli --ldb 调试模式可选异步（--ldb）或同步（--ldb-sync-mode）：异步 fork 隔离进程，不修改主实例状态，适合逻辑验证；同步阻塞客户端，真实反映数据变更，调试一致性问题必须用它。
redis-cli --ldb 调试模式必须用异步还是同步？
取决于你是否需要观察脚本对真实 Redis 状态的副作用。异步模式（--ldb）会 fork 一个隔离进程，redis.call() 执行的命令不会写入主实例，适合快速验证逻辑；同步模式（--ldb-sync-mode）会阻塞所有客户端请求，但能真实反映 KEYS/ARGV 修改、键值变更、事务行为等——调试数据一致性问题时必须用它。
常见错误现象：redis-cli -a pwd --ldb --eval script.lua key1 key2 , arg1 arg2 运行后卡住无响应，其实是进入了调试器等待输入，不是崩溃；误以为“没反应”就 Ctrl+C 中断，结果跳过了关键断点。
- 同步模式下，务必提前通知团队：该 Redis 实例将拒绝新请求，直到脚本退出或手动
quit - 异步模式无法观测
redis.pcall()失败后的实际 error message，因为错误上下文在 fork 后被截断 - 两种模式都要求 Lua 脚本里有
print()或redis.debug()，否则调试器里看不到变量值
VSCode 里运行 lua 脚本不能替代 redis-cli --ldb
本地用 lua main.lua 或 VSCode 的 Code Runner 执行，只能测纯 Lua 逻辑（比如字符串拼接、table 遍历），但只要脚本里出现 redis.call("GET", "x") 就会报错：attempt to call a nil value (global 'redis')。因为 Redis 的 redis 表是服务端注入的，Lua 解释器本身不提供。
如果你试图在 VSCode 里直接调试含 Redis 调用的脚本，会卡在第一行 redis.call 上。这不是配置问题，是架构限制。
- VSCode + Lua 插件仅适用于：预处理参数、构造 KEYS/ARGV 数组、校验输入格式等前置逻辑
- 真实 Redis 上下文调试，必须走
redis-cli --ldb或封装它的 wrapper 工具（如aa2013/redis-lua-debug里的main.lua） - 想在 VSCode 里单步进
redis.call？不可能。它底层是 C 函数调用，不在 Lua 栈帧里
调试时 print 和 redis.debug() 的行为差异
print("foo") 输出到 redis-cli 的终端 stdout，而 redis.debug("bar") 输出到 LDB 调试器的当前 session，且只在调试模式下生效（生产环境执行会静默忽略）。两者输出位置、触发时机、兼容性都不同。
容易踩的坑：redis.debug(table) 直接传 table 会报错，必须先 redis.debug(cjson.encode(table)) 或用 cmsgpack.pack() 序列化；而 print(table) 只会输出 table: 0x... ，毫无调试价值。
- 调试初期建议统一用
redis.debug("key", key, "argv", ARGV[1])，多个参数会被空格分隔输出 -
print()在非调试模式下仍可见，适合加日志埋点；redis.debug()是调试专属，上线前可批量删掉 - 不要依赖
io.write—— Redis 的 Lua 环境禁用了标准 I/O
参数传递中逗号前后空格导致 KEYS/ARGV 错位
redis-cli --eval script.lua key1 key2 , arg1 arg2 这条命令里，, 前后**必须有空格**。少一个空格，比如写成 key1 key2,arg1 arg2，Redis 就会把 arg1 当作最后一个 KEY，导致 KEYS 数组长度为 3、ARGV 为空——脚本里 ARGV[1] 访问直接报错 index out of bounds。
这个错误不报语法异常，只在运行时报 ERR Error running script，堆栈里还找不到具体哪行出问题，非常难定位。
- VSCode 中写好命令后，建议复制到终端先用
echo检查空格：echo "key1 key2 , arg1 arg2" | hexdump -C，确认20 2c 20（空格+逗号+空格）存在 - 脚本开头加防御性判断：
if #ARGV == 0 then redis.error("no ARGV provided") end - 使用封装脚本（如
aa2013/redis-lua-debug）自动补全空格和路径，避免手输失误
真正麻烦的从来不是怎么启动调试器，而是当 redis.debug() 输出一堆 nil 时，得判断是参数根本没传进来，还是中间某次 redis.call() 失败后没做错误处理，又或者 KEYS/ARGV 被意外修改了引用。这些细节藏在一次 , 的空格里，也藏在你删掉的那行 redis.error() 里。
