lua命令能运行不等于环境可用，require"socket"失败主因是包管理器安装的lua5.4缺luarocks、缺配套头文件且package.path未包含模块路径，根本解法是源码编译并手动配置lua_path与luarocks。
lua 命令能跑不等于 Lua 环境可用——绝大多数失败都卡在模块加载、C 扩展编译或路径错配，不是安装本身。
用包管理器装的 lua5.4 为什么 require "socket" 会报错
因为 Ubuntu/Debian 的 lua5.4 包只含解释器二进制，不带 luarocks，也不提供配套的 lua5.4-dev 头文件（即使你 apt install lua5.4-dev，版本也可能滞后或路径不匹配）。更关键的是：package.path 默认不包含 /usr/share/lua/5.4 这类目录，require 根本找不到第三方模块。
- 验证当前路径：运行
lua -e "print(package.path)"，输出里若没有?.lua形式的可写路径，就注定无法加载本地模块 - 临时补救：设环境变量
LUA_PATH='/usr/share/lua/5.4/?.lua;/usr/share/lua/5.4/?/init.lua;./?.lua' - 但根本解法是重装——别依赖系统包管理器提供的 Lua 生态闭环，它本来就不存在
luarocks install luasocket 报 “Could not find Lua header files”
这不是网络问题，是 luarocks 编译 C 模块时找不到 lua.h。系统包管理器装的 lua5.4-dev 可能对应旧版 Lua，而你自己编译的 Lua 又没把头文件放对位置。
- 先确认头文件是否存在：
ls $HOME/local/include/lua.h（如果你装到用户目录）或ls /usr/local/include/lua.h - 用
luarocks --lua-dir $HOME/local configure显式告诉它头文件在哪 - 验证配置是否生效：
luarocks config variables.LUA_INCDIR应输出实际路径 - 漏掉
libreadline-dev会导致交互式 Lua 崩溃，但它不影响 luarocks 编译——别混淆这两类依赖
自己编译 Lua 5.4 时，make linux test 成功但 require "socket" 仍失败
说明 Lua 解释器本身没问题，但模块路径和动态库链接没对齐。常见于未设置 LUA_PATH 或 LUA_CPATH，或 luarocks 安装模块后没刷新缓存。
- 检查
luarocks安装目标路径：luarocks path输出应含share/lua/5.4和lib/lua/5.4 - 手动加路径（临时）：
LUA_PATH="$(luarocks path --lrpath)/?.lua;;" lua -e "require'socket'" - 如果提示
undefined symbol: luaL_setfuncs，说明模块是为 Lua 5.3 编译的，ABI 不兼容——必须用同版本 Lua + 同版本 luarocks 重建 - 不要用
sudo make install覆盖/usr/bin/lua，否则系统工具（如某些 debhelper 脚本）可能异常
#!/usr/bin/env lua 运行脚本报 “bad interpreter: No such file or directory”
Shebang 行查的是 env 是否能在 $PATH 中找到名为 lua 的可执行文件。一旦你装的是 $HOME/local/bin/lua，但 $HOME/local/bin 不在 PATH 里，或者 env 找到的是另一个版本（比如 /usr/bin/lua5.3），就会失败。
- 最稳写法是写死路径：
#!/home/you/local/bin/lua（用which lua确认准确路径） - 确保脚本有执行权限：
chmod +x script.lua - Windows 编辑后带 CRLF 换行符也会触发该错误，用
dos2unix script.lua清理 - 别信
env——它只按名字找，不按版本找，也不管你装在哪
require 就静默失败，luarocks 就卡在编译，shebang 就报 interpreter 错误——它们不报具体原因，只甩给你一行模糊提示。
