必须源码编译安装lua 5.4到用户目录并手动对齐路径，因apt安装的lua5.4缺头文件、无配套luarocks、路径错配且abi不一致，导致require"socket"失败、luarocks报错及shebang执行异常。
lua5.4 看似省事，但大概率导致 require "socket" 失败、luarocks install 报 “Could not find Lua header files”、脚本执行报 “bad interpreter”，根本原因是系统包不提供完整开发闭环——缺头文件、缺配套 luarocks、路径错配、ABI 不一致。真要稳定运行 Lua 脚本（尤其含 C 模块或需第三方库），必须源码编译安装并手动对齐路径。
自己编译 Lua 5.4 到用户目录，避开系统污染
这是最可控的方式，避免 apt upgrade 覆盖或和 /usr/bin/lua 冲突。
- 先装依赖：
sudo apt install build-essential libreadline-dev libncurses5-dev libssl-dev；漏掉libreadline-dev会导致交互式 Lua 无法用上下箭头翻历史命令 - 下载解压：
wget https://www.lua.org/ftp/lua-5.4.7.tar.gz && tar zxf lua-5.4.7.tar.gz && cd lua-5.4.7 - 验证编译没问题：
make linux test（别急着make install） - 装到用户目录：
make INSTALL_TOP=$HOME/local install - 加进
PATH：echo 'export PATH=$HOME/local/bin:$PATH' >> ~/.bashrc && source ~/.bashrc - 确认生效：
which lua应输出/home/you/local/bin/lua，lua -v显示Lua 5.4.7
装 luarocks 并显式指定 Lua 安装路径
luarocks 默认找 /usr，你装在 $HOME/local 就必须告诉它——否则所有 install 都会卡在找不到 lua.h。
Zynq Linux Hardware Debug
下载
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 下载解压：
wget https://luarocks.org/releases/luarocks-3.9.2.tar.gz && tar zxf luarocks-3.9.2.tar.gz && cd luarocks-3.9.2 - 配置时显式传参：
./configure --lua-dir=$HOME/local - 编译安装：
make && sudo make install - 验证头文件路径：
luarocks config variables.LUA_INCDIR应输出/home/you/local/include - 检查是否存在：
ls $HOME/local/include/lua.h；若无，说明make install没跑完或路径设错
Shebang 和脚本执行权限必须严格匹配
报 “bad interpreter: No such file or directory” 几乎全是 #!/usr/bin/env lua5.4 这类写法惹的祸——env 找不到对应命令，不是 Lua 崩了。
- 用
which lua看真实路径，Shebang 就写死它，例如：#!/home/you/local/bin/lua - 必须加执行权限：
chmod +x script.lua - 若脚本从 Windows 编辑过，可能带 CRLF 换行符，用
dos2unix script.lua清理 - 别用
#!/usr/bin/env lua，除非你确保PATH里第一个lua就是你装的版本
验证模块加载能力：package.path 和 LUA_PATH 得对上
lua -v 成功 ≠ require "socket" 成功。关键看 Lua 是否知道去哪儿找模块。
- 检查当前路径：
lua -e "print(package.path)"；若没含?.lua形式路径，require必然失败 -
luarocks安装模块后，路径通常在$HOME/local/share/lua/5.4/；把它加进LUA_PATH：export LUA_PATH="$HOME/local/share/lua/5.4/?.lua;;" - 临时测试：
LUA_PATH="$(luarocks path --lrpath)/?.lua;;" lua -e "require'socket'" - 如果报
undefined symbol: luaL_setfuncs，说明模块是为 Lua 5.3 编译的，ABI 不兼容——必须用同版本luarocks重装
require 就会静默失败或报错，而错误信息往往指向错的方向。
