第 2 章 环境搭建

本章使用 Lua 官方发行版，不依赖特定 IDE 或第三方包管理器。先在本地建立可重复运行的 Lua 5.4 环境，再开始练习。

安装 Lua 5.4

Windows

推荐使用 winget 安装，或者从 LuaBinaries 获取 5.4 版本。安装后确认版本：

winget search lua
lua -v

如果系统找不到 lua，把解释器所在目录加入 PATH，然后重新打开终端。

macOS

使用 Homebrew：

brew install lua
lua -v

Linux

Debian 或 Ubuntu：

sudo apt update
sudo apt install lua5.4
lua5.4 -v

也可以从 Lua 官方下载页 获取源码：

curl -R -O 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 all test

不同平台的编译目标不同，请以官方 INSTALL 文件为准。

交互环境与脚本运行

Lua 没有参数启动时进入交互模式：

$ lua
> 1 + 2
3
> = "Lua" .. " 5.4"
Lua 5.4

以文件方式运行：

lua hello.lua

传递命令行参数：

lua args.lua first second

args.lua：

for index, value in ipairs(arg) do
  print(index, value)
end

输出：

1	first
2	second

编辑器与项目目录

任何纯文本编辑器都可以编写 Lua。建议使用支持 Lua 语法高亮、缩进和调试的编辑器，并统一用空格缩进。

从简单的练习目录开始：

lua-practice/
├── hello.lua
├── exercises/
│   └── 01-basics.lua
└── README.md

项目变大后再拆分为 src/、tests/ 和 data/。不要在初学阶段引入不必要的构建工具。

常见环境问题

命令找不到

确认解释器版本：

lua -v
lua5.4 -v

有些系统同时安装多个版本，需要显式调用 lua5.4。可以在项目 README 中记录实际命令，避免团队成员混淆。

源代码包含中文导致报错

把文件保存为 UTF-8。不同编辑器保存编码的策略不同，可以在文件头注释中记录编码约定：

-- UTF-8

脚本找不到模块

先确认模块路径相对于当前工作目录是否一致，再检查 package.path。第 10 章会详细说明模块加载。

输出乱码

终端和文件必须使用兼容的编码。Windows 终端可执行 chcp 65001 切换到 UTF-8，但生产脚本不应依赖终端临时设置。

上一章：Lua 简介 | 下一章：基本类型与变量