Redis Lua脚本在Linux执行失败大概率是Windows的CRLF换行符(\r\n)导致,Linux Redis只认LF(\n);可用file、cat -A或xxd命令确认,推荐用dos2unix、sed -i或重写脚本修复,并通过VS Code设置和.editorconfig预防。

Windows 下写的 Redis Lua 脚本传到 Linux 执行失败,大概率不是语法或逻辑问题,而是 \r\n 换行符被当成非法字符解析了。Redis 的 Lua 引擎在 Linux 上只认 \n,遇到 \r 会直接报错(比如 $'\r': command not found 或脚本无法加载),尤其在用 redis-cli --eval 方式调用时特别敏感。
怎么确认是 CRLF 换行符导致的
在 Linux 终端运行:file script.lua —— 如果输出含 CRLF 字样,就是它了;cat -A script.lua | head -n 2 —— 看末尾是否有 ^M$(^M 就是 \r);xxd script.lua | head -n 2 —— 查看十六进制,找 0d 0a(CRLF)而非 0a(LF)。
三种可靠修复方式(按推荐顺序)
方案一:用 dos2unix 一键转换(最稳,适合批量)
- Ubuntu/Debian:sudo apt install dos2unix
- CentOS/RHEL:sudo yum install -y dos2unix 或 sudo dnf install -y dos2unix
- 执行:dos2unix script.lua
- 验证:file script.lua 应显示 with CRLF line terminators → 变成 with LF line terminators
方案二:用 sed 原地清理(无额外依赖,应急首选)
- 直接执行:sed -i 's/\r$//' script.lua
- 注意:-i 是原地修改,别漏掉;\r$ 只删行尾的 \r,不碰内容里的 \r(比如字符串字面量);
- 若提示 invalid reference \r,说明 shell 解析出错,改用:sed -i $'s/\r$//' script.lua(启用 bash 的 ANSI-C 引用)。
方案三:在 Linux 中重写脚本(彻底规避风险)
- 用 vim script.lua 新建文件;
- 粘贴内容时,确保是从 VS Code 等编辑器「复制纯文本」(且 VS Code 右下角已设为 LF);
- 不要用 Windows 记事本、Notepad++ 默认设置、或远程桌面直接拖拽文件——这些极大概率带 \r。
VS Code 用户必须做的预防设置
每次新建或保存 Lua 脚本前,检查右下角状态栏:
- 点击 CRLF → 选 LF;
- 或全局设置:"files.eol": "\n" 加入 settings.json;
- 更进一步:在项目根目录加 .editorconfig 文件,写入:
[*.lua]<br>end_of_line = lf<br>insert_final_newline = true
Git 提交前就能拦住 CRLF。
真正麻烦的不是改一次换行符,而是脚本被多人协作、跨平台编辑、CI/CD 流水线自动拉取后悄悄混入 \r。把 file 和 sed -i 's/\r$//' 当成部署前的 checklist 项,比等线上 redis-cli --eval 报错再排查快得多。


















