确认lua安装需先运行lua -v或lua5.4 -v查版本，重点验证是否为所需版本（如5.4.6）而非仅是否存在；常见问题包括动态库缺失（如libreadline.so.8）、头文件混用、模块路径未配置（lua_path/lua_cpath）、包管理器安装的abi兼容性限制，推荐源码编译以精确控制依赖与特性。
如何确认系统是否已安装 Lua 及版本是否满足需求
直接运行 lua -v 或 lua5.4 -v（取决于发行版打包习惯）能快速判断。很多 Linux 发行版预装了 Lua，但版本往往偏低（如 Ubuntu 22.04 自带 lua5.3），而项目依赖 lua-5.4.6 或 luajit 时就会出问题。重点不是“有没有”，而是“是不是你要的那个”。
常见错误现象：lua: error while loading shared libraries: libreadline.so.8: cannot open shared object file——这说明编译时链接了系统未提供的动态库，不是没装，是装得不干净。
- 用
which lua和readelf -d $(which lua) | grep 'Shared library'查看实际加载的依赖路径 - 若输出含
libreadline.so.8但系统只有libreadline.so.7（如 Debian 11），必须重编译或换用静态链接 - 不要依赖包管理器安装的
lua-dev或lua-devel头文件来编译新版本——它们对应旧版，混用会导致lua.h: No such file or directory
源码编译 Lua 5.4.x 的最小可靠步骤
官方源码包（lua-5.4.6.tar.gz）解压后默认不启用 readline 支持，但多数人需要交互式 lua 命令行（带历史、编辑功能）。关键在 make 前改 src/Makefile，而不是盲目加 --with-readline（Lua 官方 Makefile 不支持 autoconf 参数）。
- 先确保装好
libreadline-dev（Debian/Ubuntu）或readline-devel（RHEL/CentOS） - 编辑
src/Makefile：将LIBS= -Wl,-E -ldl -lm改为LIBS= -Wl,-E -ldl -lm -lreadline -lhistory - 执行
make linux test（不是make install），验证生成的lua可执行文件能正常启动并支持上下键调历史 - 安装时用
sudo make INSTALL_TOP=/usr/local/lua-5.4.6 install，避免覆盖系统默认路径；再用sudo ln -sf /usr/local/lua-5.4.6/bin/lua /usr/local/bin/lua5.4显式区分版本
运行测试时遇到 “module ‘xxx’ not found” 怎么办
这不是 Lua 安装失败，而是 LUA_PATH 和 LUA_CPATH 没指向你放模块的地方。Lua 启动时只查固定路径，不会自动扫 /usr/local/share/lua/5.4 以外的位置——哪怕你用 make install 装进去了。
Zynq‑7000 / Zynq UltraScale+ 硬件调试技能。适用于 Xilinx Zynq（Cortex‑A9/A53 + FPGA）Linux 环境，调试 I2C、I2S、UART、GPIO 等外设。包括设备树配置、内核驱动、用户空间调试工具、交叉编译和常见问题排查，支持 PetaLinux 开发。
- 检查当前值：
lua -e "print(package.path)"和lua -e "print(package.cpath)" - 临时生效：运行前设环境变量，例如
LUA_PATH='/usr/local/share/lua/5.4/?.lua;/usr/local/share/lua/5.4/?/init.lua;;' lua myscript.lua - 永久生效：在
~/.bashrc加export LUA_PATH='/usr/local/share/lua/5.4/?.lua;/usr/local/share/lua/5.4/?/init.lua;;'，注意末尾两个分号保留默认搜索路径 - 写 C 扩展模块时，
LUA_CPATH必须包含.so文件所在目录，且文件名要匹配模块名（如require 'mymod'对应mymod.so，不能叫mymodule.so）
为什么建议跳过包管理器直接编译，而不是用 apt install lua5.4
因为发行版打包会做 ABI 兼容妥协：Debian 的 lua5.4 包强制链接系统 libreadline8，但该库在旧内核或容器里常缺失；CentOS Stream 的 lua 包又默认禁用 luaL_dostring 等调试接口，导致某些嵌入式脚本直接报 attempt to call a nil value。源码编译才能控制每个开关。
-
make clean后重新make linux比反复apt install --reinstall更可控 - 交叉编译嵌入式设备时，包管理器根本没提供对应架构的 Lua 包，只能靠源码
- 调试时需要
lua -g（启用 debug info），但多数二进制包默认关闭-g编译选项
最易被忽略的是：编译完别只测 lua -v，一定要跑 lua -i 进交互模式，按上下键、Ctrl+R 搜历史、输入 os.date() 看是否崩溃——这些才是真实使用场景。静默通过 make test 不代表 runtime 稳定。
