在Linux系统中安装Lua脚本语言是许多开发者和系统管理员的常见需求,Lua以其轻量级、高效和嵌入性强的特点,广泛应用于游戏开发、嵌入式系统、脚本扩展等场景,本文将详细介绍在Linux环境下安装Lua的多种方法,包括通过包管理器快速安装和源码编译安装,并涵盖环境配置、验证安装及常见问题解决,帮助读者顺利完成Lua环境的搭建。

安装前的准备
在开始安装Lua之前,需确保系统满足基本要求并完成必要的准备工作,确认当前Linux发行版,不同发行版使用的包管理器和依赖管理方式存在差异(如Ubuntu/Debian使用apt,CentOS/RHEL使用yum/dnf,Arch使用pacman),检查系统架构(x86_64、arm64等),确保下载的安装包与架构匹配,安装编译源码所需的依赖工具(若选择源码编译方式),包括GCC编译器、Make工具、readline库(提供命令行编辑功能)等,以Ubuntu/Debian为例,可通过以下命令安装依赖:
sudo apt update && sudo apt install -y build-essential libreadline-dev
对于CentOS/RHEL系统,可执行:
sudo yum groupinstall "Development Tools" && sudo yum install readline-devel
通过包管理器安装(适合新手)
包管理器安装是最快捷的方式,适合不需要自定义编译选项的用户,主流Linux发行版通常已将Lua收录在官方仓库中,可直接通过命令安装。
Ubuntu/Debian系统
使用apt包管理器安装,默认安装最新稳定版(通常为Lua 5.4或5.3):
sudo apt install lua5.4 lua5.4-dev
lua5.4是Lua解释器,lua5.4-dev是开发库,包含头文件和链接库,供其他程序调用Lua时使用。
CentOS/RHEL系统
通过yum或dnf安装,若使用CentOS 7或RHEL 7及以下版本,使用yum:
sudo yum install lua lua-devel
对于CentOS 8+、RHEL 8+或Fedora系统,推荐使用dnf:
sudo dnf install lua lua-devel
Arch Linux系统
Arch仓库的包名较为简洁,直接安装即可:
sudo pacman -S lua
包管理器安装的优势是操作简单、依赖自动处理,但缺点是版本可能较旧(如部分系统默认为Lua 5.1),若需最新版本,建议选择源码编译安装。

源码编译安装(适合需自定义版本或功能的用户)
通过源码编译安装可以灵活选择Lua版本(如最新的Lua 5.4.6)及启用/禁用特定功能(如启用JIT即时编译),以下是详细步骤:
下载Lua源码
访问Lua官方下载页面(https://www.lua.org/download.html),获取最新稳定版的源码包(以lua-5.4.6.tar.gz为例),使用wget下载:
wget https://www.lua.org/ftp/lua-5.4.6.tar.gz
解压并进入源码目录
tar -zxf lua-5.4.6.tar.gz && cd lua-5.4.6
修改Makefile(可选)
默认情况下,Lua会安装到/usr/local目录下,若需自定义安装路径(如/usr/local/lua5.4),可编辑Makefile文件,修改INSTALL_TOP变量:
vim Makefile # 将 INSTALL_TOP = /usr/local 修改为 INSTALL_TOP = /usr/local/lua5.4
编译与安装
执行以下命令编译源码并安装:
make linux test # linux平台编译,并运行测试用例 sudo make install
编译完成后,可执行文件(如lua、luac)会默认安装到/usr/local/bin目录下(若自定义路径,需手动将该目录加入PATH环境变量)。
验证安装
通过以下命令检查Lua版本:
lua -v
若输出类似Lua 5.4.6 Copyright (C) 1994-2026 Lua.org, PUC-Rio,则表示安装成功。
环境配置与验证
配置环境变量(若源码编译时指定了非默认路径)
若Lua安装到自定义路径(如/usr/local/lua5.4/bin),需将该路径加入系统的PATH环境变量,以便全局调用lua命令,编辑~/.bashrc或~/.zshrc文件(根据使用的shell):
echo 'export PATH=/usr/local/lua5.4/bin:$PATH' >> ~/.bashrc source ~/.bashrc # 立即生效
测试Lua交互式环境
在终端输入lua进入交互式模式,执行简单命令:

print("Hello, Lua!")
1 + 1
若输出Hello, Lua!和2,则说明Lua环境已正确配置。
运行Lua脚本
创建一个简单的Lua脚本文件(如test.lua):
echo 'print("This is a Lua script")' > test.lua
lua test.lua
若输出This is a Lua script,则脚本执行正常。
常见问题与解决方案
问题:执行lua -v提示“command not found”
原因:Lua未安装或未加入PATH环境变量。
解决:若通过包管理器安装,检查包名是否正确(如Ubuntu使用lua5.4而非lua);若源码编译到自定义路径,需按上述步骤配置PATH环境变量。
问题:编译时报错“undefined reference to ‘readline’”
原因:缺少readline开发库。
解决:根据发行版安装对应依赖(如Ubuntu安装libreadline-dev,CentOS安装readline-devel)。
问题:需要切换Lua版本
原因:系统同时存在多个Lua版本(如5.3和5.4)。
解决:可通过创建软链接指定默认版本,或使用完整路径调用指定版本(如/usr/local/lua5.4/bin/lua -v)。
问题:Windows与Linux换行符差异导致脚本运行错误
原因:Windows下编写的Lua脚本包含\r\n换行符,Linux无法识别。
解决:使用dos2unix工具转换换行符:
sudo apt install dos2unix && dos2unix script.lua
通过以上方法,用户可根据自身需求选择合适的安装方式,快速在Linux系统中搭建Lua开发环境,无论是简单的脚本编写还是复杂的项目开发,Lua都能凭借其简洁高效的特点为开发工作提供有力支持。








