ubuntu/debian 的 apt 默认安装旧版 lua（如 5.3.6）因系统工具依赖，升级易破坏兼容；需手动编译或换源安装 lua 5.4+，并配好 luarocks 与头文件路径。

Ubuntu/Debian 上用 apt 安装 Lua 为什么默认不是最新版

Linux 发行版仓库里的 lua 包通常锁定在 LTS 版本（比如 Ubuntu 22.04 默认是 Lua 5.3.6），因为系统工具如 apt、dpkg 的部分脚本依赖它，升级可能破坏兼容性。

• 想用 Lua 5.4+？别直接 apt install lua，得手动编译或换源
• apt install lua5.4 可能存在，但模块（如 luarocks）未必配套，require "socket" 会报错
• 检查当前版本：lua -v；确认安装路径：which lua，避免和系统自带的 /usr/bin/lua 混淆

从源码编译安装 Lua 5.4 的关键三步

这是最稳妥、也最常被跳过的做法——尤其当你需要 lua 和 luac 都可用，且不污染系统路径时。

• 先装依赖：sudo apt install build-essential libreadline-dev libncurses5-dev libssl-dev
• 下载解压后进目录，执行：make linux test（不是 make install！先验证编译没问题）
• 安装到用户目录更安全：make INSTALL_TOP=$HOME/local install，然后把 $HOME/local/bin 加进 $PATH

漏掉 libreadline-dev 会导致交互式 Lua 不支持上下箭头翻历史命令；没加 INSTALL_TOP 直接 sudo make install，容易覆盖系统 /usr/bin/lua，后续 apt upgrade 可能出问题。

运行 Lua 脚本时提示 “bad interpreter: No such file or directory” 怎么办

这错误几乎全是 Shebang 行惹的祸，不是 Lua 本身的问题。

• 检查脚本第一行是不是写成了：#!/usr/bin/env lua5.4，但系统里只有 lua 或 lua5.3
• 用 which lua 看实际路径，Shebang 必须严格匹配，比如是 /home/you/local/bin/lua，就写死它，别依赖 env
• 脚本权限必须是可执行：chmod +x script.lua；Windows 换行符（CRLF）也会触发这个错误，用 dos2unix script.lua 清理

用 luarocks 装包却提示 “Could not find Lua header files”

luarocks 编译 C 模块（比如 luasocket、lpeg）时，需要 Lua 的 .h 文件，但 apt 安装的 lua 包默认不含开发头文件。

• 如果用 apt 装的 Lua：补装 lua5.4-dev（版本号要一致）
• 如果自己编译安装的：确保 make install 同时生成了 include/ 目录，且 luarocks 能读到——可通过 luarocks --lua-dir $HOME/local configure 显式指定
• 验证头文件是否存在：ls $HOME/local/include/lua.h，不存在说明编译步骤漏了 make install 或路径设错了

头文件路径不对，luarocks install luasocket 就会卡在 “gcc: error: lua.h: No such file or directory”，而不是报错信息里写的那句，得看完整输出里的最后一行 gcc 错误。