Lua必备文档：Lua学习笔记
Lua必备文档：Lua学习笔记是本文要介绍的内容，主要是在学习Lua时碰到的一些问题和得出的心得体会，适合没有任何Lua基础的朋友看。笔者会不定期的将自己的学习整理成笔记，同时由于笔者是本月刚接触Lua，也是正在学习的阶段。
我学习的最终目的是想在基于Allegro图像库的GUI构建中应用Lua，也许有的朋友的最终目的是在Web中应用Lua--或者别的目的--不过我想在通往最终应用的路途中，总会有一些共通的地方。希望我这些文字对你有所帮助。
首先提一下很容易找到的、比较正规的中文参考资料 《PIL5.0中文教程》，《Lua使用手册5.1》(风云翻译)。
本节的目的在于在VS2005中搭建一个用于测试Lua的环境。侧重点为C/C++与Lua的交互--在CPP文件中应用Lua脚本。
如何编写.lua文件：
任何文本编辑器都可以，只要写的语句符合Lua语法。保存的时候后缀名为 “.lua”。我用的Lua编辑器是LuaEdit,不过感觉除了能检测语法是不是正确之外，跟记事本没什么区别...
如何配置Lua使用环境：
如何生成编译后的LUA文件：
一定要解决上面3个问题，千万别急躁，直到你成功的配置了使用环境、能够写简单的.lua文件并生成相应的二进制中间文件之前，不要继续阅读以下文字。
好了，让我们开始RTFS(Read The Fuxking Source)。
以下是Lua脚本
--test.lua function f ( x, y) return x + y end
通过LuaEdit语法测试
//以下是test.c文件
//
// Lua Test Object
// C++ Source lua_test.cpp
//
//
// Include Files
//
extern "C"
{
#include "D:\\My Documents\\Visual Studio 2005\\Projects\\lua\\lua\\lua.h"
#include "D:\\My Documents\\Visual Studio 2005\\Projects\\lua\\lua\\lualib.h"
#include "D:\\My Documents\\Visual Studio 2005\\Projects\\lua\\lua\\lauxlib.h"
}
//
// Libraries
//
#pragma comment( lib ,"D:\\My Documents\\Visual Studio 2005\\Projects\\lua\\release\\lua.lib")
//
// Global Variables
//
lua_State *L;
//
// Lua Functions
//
double f( double x, double y )
{
double ret;
lua_getglobal( L, "f"); // 获取全局变量f
lua_pushnumber( L,x); // 操作数压栈
lua_pushnumber( L,y); // 操作数压栈
lua_call( L, 2, 1); // 执行：2个操作数，1个返回值
//lua_pcall( L, 2, 1, 0); // 保护模式的lua_call,0为错误处理码。具体应用暂时不明，在使用手册中有粗略介绍
ret = lua_tonumber( L, -1); // 将栈顶元素转换成数字并赋值给ret
lua_pop( L, 1); // 从栈中弹出一个元素
return ret;
}
//
// Main Functions
//
int main( void)
{
int error;
L = lua_open(); // 创建Lua接口指针（借用DX的术语，本质是个堆栈指针）
luaopen_base(L); // 加载Lua基本库
luaL_openlibs(L); // 加载Lua通用扩展库
error = luaL_loadfile(L, "test.lua"); // 读取Lua源文件到内存
double ret = f( 10, 3.4); // 调用模版函数f
printf( "ret = %f", ret); // 输出结果，C语言的东西，跟Lua无关
getchar(); // console程序调试技巧，方便观察结果
lua_close( L); // 关闭Lua接口
return 1;
} 你可以直接复制这些代码到.lua 和.cpp文件里，也可以手动敲进去，我建议后者--就跟上课记笔记一样--好记性不如烂笔头。
编译成功了吗？如果不成功一定是环境没有配置好。不过就算编译成功也是白搭：D。程序在执行到函数f()中的“ lua_call( L, 2, 1);”这句时肯定会跳出来。如果你眼睛反映够快，并且英语够好，那么在0.3秒之内你将看到来自Lua的Debug信息：PANIC: unprotected error in call to Lua API (attempt to call a nil value)，这是我在程序里故意留的一个BUG。
让我们来看看为什么出错了。
在调用“ lua_call( L, 2, 1);”的时候“调用了一个空的值”，说明栈是空的。Lua在执行脚本中的函数的时候，首先会把函数体压栈，然后是操作数。
那么函数体去哪了？原因在于main()中的error = luaL_loadfile(L, "test.lua"); 这句。
首先Lua是“动态编译的脚本语言”，而loadfile只是把源文件加载到内存中，还少了“编译”这一步，可以用“luaL_dofile(L,"test.lua");”来替换，它既加载又编译。替换之后执行应该就没有问题了。
但是还没完，luaL_dofile 实际上是个宏：
#define luaL_dofile(L, fn) \ (luaL_loadfile(L, fn) || lua_pcall(L, 0, LUA_MULTRET, 0))
LUA_MULTRET也是宏定义，值为-1，表示函数有多个返回值(Lua规则，pil 24.2--堆栈)。
扩展开来就是以下两句：
luaL_loadfile(L, fn); lua_pcall(L, 0, LUA_MULTRET, 0);
pcall以上述参数执行的时候，会把加载到内存中的源程序编译成可以用于执行的2进制代码，并将全局变量压栈（在Lua中，函数也是变量，pil 2.5 -- Functions，毕竟函数名和函数体是不同的2个东西）。就跟PE文件格式里的Section一样（PE文件就是Windows3.1之后的.exe/.dll文件）。当然如果你不知道什么PE文件也没关系--我只是打个比方--就当成VS2005编译代码时生成的.obj文件。
虽然实际使用中99%的情况都是直接使用dofile，但是我想将该问题提出来说可以更加直观的理解“动态编译”。
另外一个需要特别注意的是，在test.lua中，定义了一个模板函数 f，接受2个操作数( x , y )，所以需要在CPP文件中定义该函数的CPP模板 double f ( double x, double y)，它们一定是成对出现的（不然我们为什么要用Lua呢：D）。当然，你也可以让CPP的函数 f 接受3个参数 x, y, z，但是只把y , z 压栈，x单独做处理，同样的道理也可以应用于LUA文件。源代码我就不写了，你可以当作练习。
最后，我想谈谈luac.exe 和.OUT文件--也就是独立的LUA编译器生成的2进制文件。因为.LUA太直接，源代码可以直接看到，同时动态编译也是要花费额外的时间（可能还有别的理由，通过进一步的学习应该可以发现），所以使用.out文件是比较好的方案。
那么现在直接loadfile总可以了吧？很可惜不行！loadfile这个函数实在太傻了，只管读入文件，而负责判断读入的是源文件还是经过编译的二进制代码的工作是由lua_pcall()来做的--如果是源文件，就编译后压栈，如果是二进制代码，就直接压栈。
再一个就是，如果你在程序中使用OUT文件，在VS2005中调试的时候，依然会报attempt to call a nil value的错误--就算你用的是luaL_dofile()！
比如：error = luaL_dofile(L, "luac.out");