# 安裝 Lua
Lua 以 [源代碼](http://www.lua.org/ftp/) 的形式發布，使用之前，你需要構建它。 構建 Lua 非常簡單，因為 Lua 是用純粹的 ANSI C 實現的，在所有具備 ANSI C 編譯器的平臺都可以直接編譯。 同時，Lua 也可以直接以 C++ 形式編譯。 下面介紹了類 Unix 平臺上的構建流程，另有 [其它系統構建介紹](#other) 與 [配置選項](#customization) 以作參考。
如果你沒有時間或興趣自己編譯 Lua， 可以從 [LuaBinaries](http://lua-users.org/wiki/LuaBinaries) 獲取編譯后的二進制文件 或者從 [LuaDist](http://luadist.org/) 這里獲取 Lua 的多平臺發布版（自帶電池）。
### 構建 Lua
在大多數類 Unix 平臺上，輸入 "`make`" 加上合適的平臺名即可。步驟如下：
1. 打開一個控制臺窗口，切換到 `lua-5.3.0` 目錄。 目錄下的 `Makefile` 文件內包含了構建與安裝流程。
2. 運行 "`make`" 并查看你的平臺是否列在其中。 當前支持的平臺有：
aix bsd c89 freebsd generic linux macosx mingw posix solaris
如果你的平臺在其中，運行 "`make xxx`" 即可，xxx 代表你的平臺名。
如果你的平臺不在其中，先嘗試最相近的平臺，再按 posix generic c89 順序依次嘗試。
3. 編譯過程很短，最終在 `src` 目錄下生成三個文件： lua (解釋器), luac (編譯器)和 liblua.a (靜態庫) 。
4. 構建完成后，可以運行 "`make test`" 來檢查是否成功。 它會運行解釋器并打印版本號。
如果你是 Linux 系統并出現了編譯錯誤，請確認你是否安裝了 `readline` （也可能叫 `libreadline-dev` 或者 `readline-devel`）開發包。 之后，如果還有鏈接錯誤，嘗試 "`make linux MYLIBS=-ltermcap`" 。
### 安裝 Lua
一旦你構建完畢，可能希望把 Lua 安裝到系統默認位置， 那么執行 "`make install`" 即可。 系統默認位置以及如何安裝都定義在 `Makefile` 中。 這個過程可能需要有相關的權限。
運行 "`make xxx install`" 可以構建和安裝一步到位，xxx 指你的平臺名。
如果你想把 Lua 安裝在本地，運行 "`make local`"。 它會創建一個 `install` 目錄，內有 `bin`, `include`, `lib`, `man`, `share`, 子目錄，并將下列文件安裝在其中。 如果你想安裝到本地其它目錄， 運行 "`make install INSTALL_TOP=xxx`"，xxx 指你選擇的目錄。 由于安裝過程中會切換到 `src` 以及 `doc` 目錄進行， 所以當 `INSTALL_TOP` 不是絕對路徑時務必小心。
```
bin:
lua luac
include:
lauxlib.h lua.h lua.hpp luaconf.h lualib.h
lib:
liblua.a
man/man1:
lua.1 luac.1
```
這些是開發時需要的目錄。 如果你僅僅想運行一些 Lua 程序， 那么只需要 `bin` 和 `man` 下的文件。 `include` 和 `lib` 下的文件用于將 Lua 嵌入 C 或 C++ 程序。
### 定制
有三類定制，可以通過編輯文件完成：
* 怎樣安裝 Lua 以及安裝到哪里 — 編輯 `Makefile`。
* 怎樣構建 Lua — 編輯 `src/Makefile`。
* Lua 特性 — 編輯 `src/luaconf.h`。
其實你不必編輯 Makefile 文件，make 的時候在命令行指定相關變量即可。 當然，編輯保存 Makefile 可以給定制留個記錄。
另一方面，如果你需要定制一些 Lua 特性，那就需要在構建安裝 Lua 前 編輯 `src/luaconf.h` 。 編輯過的文件必須確保一致性，也就是只安裝在一個地方， 讓所有你編譯出來的用到 Lua 的程序都使用這唯一的這一份。 專家可以通過編輯 Lua 源代碼來定制更多的東西。
### 在其它系統上構建 Lua
如果你不使用常規的 Unix 工具，那么構建 Lua 的流程就取決于你使用的編譯器。 你需要創建若干工程來構建庫，解釋器以及編譯器等。請把下列源文件加入相關工程：
庫:
+ lapi.c
+ lcode.c
+ lctype.c
+ ldebug.c
+ ldo.c
+ ldump.c
+ lfunc.c
+ lgc.c
+ llex.c
+ lmem.c
+ lobject.c
+ lopcodes.c
+ lparser.c
+ lstate.c
+ lstring.c
+ ltable.c
+ ltm.c
+ lundump.c
+ lvm.c
+ lzio.c
+ lauxlib.c
+ lbaselib.c
+ lbitlib.c
+ lcorolib.c
+ ldblib.c
+ liolib.c
+ lmathlib.c
+ loslib.c
+ lstrlib.c
+ ltablib.c
+ lutf8lib.c
+ loadlib.c
+ linit.c
解釋器:
library, lua.c
編譯器:
library, luac.c
把 Lua 以一個庫形式用于你的程序，你需要知道如何用你的編譯器創建庫和使用庫。 比如，以動態加載的 C 庫形式使用 Lua，你需要了解如何創建動態庫并讓 Lua API 函數 在動態庫中可見 — _不要_ 將 Lua 庫鏈入每個動態庫。 在 Unix 下，我們建議把 Lua 庫靜態鏈入宿主程序，然后將符號導出用于動態鏈接； `src/Makefile` 就是這樣處理 Lua 解釋器的。 在 Windows 下，我們建議把 Lua 庫編譯成一個 DLL 。 無論怎樣，編譯器 luac 都應該靜態鏈接。
正如上面所述，你可以在構建 Lua 前編輯 `src/luaconf.h` 以定制一些特性。
