luac 编译器

NAME

luac - Lua 编译器

摘要

luac [ options ] [ filenames ]

说明

luacLua编译器。它把用Lua语言编写的程序翻译为二进制文件，之后这些文件可被载入并执行。

预编译单元（chunk）的主要优势在于：加载更快，保护源代码免于用户的意外修改，以及离线（off-line）语法检查。

预编译并非意味着执行更快速，因为Lua中的单元总会在执行前被编译为字节码。luac只不过允许这些字节码被存为文件用于以后的运行。

预编译单元（的尺寸）并不比对应的源代码小。它的主要目标是加快装载。

luac创建的二进制文件只能在具有相同的字长（word size）和字节序的架构间移植。

luac产生单个输出文件，它包含所有给定的源代码文件的字节码。缺省时，输出文件命名为luac.out，但你能通过选项-o改变。

在命令行中，你可以混合含有Lua源代码的文本文件和带有预编译单元的二进制文件。这很有用，因为一些预编译单元，即使它们来自不同的（但是兼容）平台，也可被组合在单个预编译单元中。

你可用“-”指示标准输入作为一个源代码文件，并用“--”告知选项的尾端（即所有剩余的参数将作为文件，即使它们以“-”开头）。

当Lua发布新版时，luac生成的二进制文件的内部格式可能改变。所以，请保留你预编译的所有Lua程序的源码文件。

 

选项

选项必须分开。

-l 产生用于Lua虚拟机的编译过的字节码清单。列举字节码对于学习Lua虚拟机很有帮助。如果没有给出文件，那么luac会载入luac.out并列举它的内容。

-o file 输出到file以代替缺省的luac.out。（你可用“-”指定标准输出，但是不能用于以文本模式打开标准输出的平台）。输出文件（名）可以是个源代码文件，因为所有的文件都在写入输出文件之前被载入。注意不要覆盖重要的文件。

-p 载入文件但不产生任何输出文件。主要用于语法检查和测试预编译单元：有语法错误的文件加载时会产生错误。Lua总是对预编译单元执行彻底的完整性测试。通过该测试的二进制码是十分安全的，可以理解为它将不会中断解释器。然而，并不保证这样的代码做的事情都有意义。（没有任何保证，因为宕机问题是无法解决的。）如果未指定文件，luac载入luac.out并测试其内容。如果文件通过完整性测试则不会显示任何消息。

-s 写入输出文件之前会剥去调试信息。在非常巨大的单元中这样可以节省一些空间，但是如果运行时发生错误，错误信息可能不似通常那样完整。例如，失去行号和局部变量名。

-v 显示版本信息。

文件

luac.out 缺省输出文件

参阅

lua(1)
http://www.lua.org/

诊断信息

错误消息应是自解释的。

作者

L. H. de Figueiredo, R. Ierusalimschy and W. Celes