跳转到内容

os

系统操作模块,属于内置模块,无需使用import导入,可直接脚本域调用其接口。

此模块也是lua的原生模块,xmake在其基础上进行了扩展,提供更多实用的接口。

注意

os 模块里面只有部分readonly接口(例如:os.getenv, os.arch)是可以在描述域中使用,其他接口只能在脚本域中使用,例如:os.cp, os.rm

os.cp

  • 复制文件或目录

行为和shell中的cp命令类似,支持路径通配符匹配(使用的是lua模式匹配),支持多文件复制,以及内置变量支持。

例如:

lua
os.cp("$(scriptdir)/*.h", "$(builddir)/inc")
os.cp("$(projectdir)/src/test/**.h", "$(builddir)/inc")

上面的代码将:当前xmake.lua目录下的所有头文件、工程源码test目录下的头文件全部复制到$(builddir)输出目录中。

其中$(scriptdir), $(projectdir) 这些变量是xmake的内置变量,具体详情见:内置变量的相关文档。

*.h**.h中的匹配模式,跟add_files中的类似,前者是单级目录匹配,后者是递归多级目录匹配。

此接口同时支持目录的递归复制,例如:

lua
-- 递归复制当前目录到临时目录
os.cp("$(curdir)/test/", "$(tmpdir)/test")

上面的复制,会把所有文件全部展开复制到指定目录,丢失源目录层级,如果要按保持原有的目录结构复制,可以设置rootdir参数:

lua
os.cp("src/**.h", "/tmp/", {rootdir = "src"})

上面的脚本可以按src根目录,将src下的所有子文件保持目录结构复制过去。

注意

尽量使用os.cp接口,而不是os.run("cp .."),这样更能保证平台一致性,实现跨平台构建描述。

2.5.7 下,新增 {symlink = true} 参数,在复制文件时候保留符号链接。

lua
os.cp("/xxx/foo", "/xxx/bar", {symlink = true})

v3.0.4 以上版本,新增 {copy_if_different = true} 参数,仅在源文件和目标文件内容不同时才执行复制操作。如果文件内容相同,则不会重新复制,这样可以保持目标文件的 mtime 等元数据不变,避免不必要的增量构建。

lua
os.cp("$(scriptdir)/config.h", "$(builddir)/inc/config.h", {copy_if_different = true})

os.mv

  • 移动重命名文件或目录

os.cp的使用类似,同样支持多文件移动操作和模式匹配,例如:

lua
-- 移动文件到临时目录
os.mv("$(builddir)/test1", "$(tmpdir)")

-- 文件移动不支持批量操作,也就是文件重命名
os.mv("$(builddir)/libtest.a", "$(builddir)/libdemo.a")

os.rm

  • 删除文件或目录树

支持递归删除目录,批量删除操作,以及模式匹配和内置变量,例如:

lua
os.rm("$(builddir)/inc/**.h")
os.rm("$(builddir)/lib/")

os.trycp

  • 尝试复制文件或目录

os.cp类似,唯一的区别就是,此接口操作失败不会抛出异常中断xmake,而是通过返回值标示是否执行成功。

lua
if os.trycp("file", "dest/file") then
end

os.trymv

  • 尝试移动文件或目录

os.mv类似,唯一的区别就是,此接口操作失败不会抛出异常中断xmake,而是通过返回值标示是否执行成功。

lua
if os.trymv("file", "dest/file") then
end

os.tryrm

  • 尝试删除文件或目录

os.rm类似,唯一的区别就是,此接口操作失败不会抛出异常中断xmake,而是通过返回值标示是否执行成功。

lua
if os.tryrm("file") then
end

os.cd

  • 进入指定目录

这个操作用于目录切换,同样也支持内置变量,但是不支持模式匹配和多目录处理,例如:

lua
-- 进入临时目录
os.cd("$(tmpdir)")

如果要离开进入之前的目录,有多种方式:

lua
-- 进入上级目录
os.cd("..")

-- 进入先前的目录,相当于:cd -
os.cd("-")

-- 进入目录前保存之前的目录,用于之后跨级直接切回
local oldir = os.cd("./src")
...
os.cd(oldir)

os.rmdir

  • 仅删除目录

如果不是目录就无法删除。

os.mkdir

  • 创建目录

支持批量创建和内置变量,例如:

lua
os.mkdir("$(tmpdir)/test", "$(builddir)/inc")

支持递归创建多级目录,如果父目录不存在会自动创建。

os.touch

  • 创建空文件或更新文件时间戳
lua
os.touch("path/to/file.txt")

如果文件不存在,则创建一个空文件。如果文件已存在,则更新文件的修改时间为当前时间。

支持批量创建:

lua
os.touch("file1.txt", "file2.txt", "file3.txt")

os.isdir

  • 判断是否为目录

如果目录不存在,则返回false

lua
if os.isdir("src") then
    -- ...
end

os.isfile

  • 判断是否为文件

如果文件不存在,则返回false

lua
if os.isfile("$(builddir)/libxxx.a") then
    -- ...
end

os.exists

  • 判断文件或目录是否存在

如果文件或目录不存在,则返回false

lua
-- 判断目录存在
if os.exists("$(builddir)") then
    -- ...
end

-- 判断文件存在
if os.exists("$(builddir)/libxxx.a") then
    -- ...
end
  • 判断是否为符号链接

判断指定路径是否为符号链接,如果不是符号链接或不存在则返回 false。

lua
if os.islink("path/to/symlink") then
    -- 是符号链接
    local target = os.readlink("path/to/symlink")
    print("链接目标:", target)
end

配合 os.ln 使用:

lua
os.ln("source.txt", "link.txt")
assert(os.islink("link.txt"))

os.dirs

  • 遍历获取指定目录下的所有目录

支持add_files中的模式匹配,支持递归和非递归模式遍历,返回的结果是一个table数组,如果获取不到,返回空数组,例如:

lua
-- 递归遍历获取所有子目录
for _, dir in ipairs(os.dirs("$(builddir)/inc/**")) do
    print(dir)
end

os.files

  • 遍历获取指定目录下的所有文件

支持add_files中的模式匹配,支持递归和非递归模式遍历,返回的结果是一个table数组,如果获取不到,返回空数组,例如:

lua
-- 非递归遍历获取所有子文件
for _, filepath in ipairs(os.files("$(builddir)/inc/*.h")) do
    print(filepath)
end

os.filedirs

  • 遍历获取指定目录下的所有文件和目录

支持add_files中的模式匹配,支持递归和非递归模式遍历,返回的结果是一个table数组,如果获取不到,返回空数组,例如:

lua
-- 递归遍历获取所有子文件和目录
for _, filedir in ipairs(os.filedirs("$(builddir)/**")) do
    print(filedir)
end

os.exit

  • 退出程序
lua
os.exit(code)

退出当前程序,并返回指定的退出码。如果不指定退出码,默认为 0(成功)。

lua
-- 正常退出
os.exit(0)

-- 异常退出
if error_occurred then
    os.exit(1)
end

os.isexec

  • 判断文件是否可执行
lua
if os.isexec("path/to/file.exe") then
    os.run("path/to/file.exe")
end

判断指定文件是否具有可执行权限。在 Unix 系统上检查文件的执行权限位,在 Windows 上检查文件扩展名。

用于动态检测可执行文件:

lua
local program = "/usr/bin/gcc"
if os.isexec(program) then
    print("程序可执行")
    os.execv(program, {"--version"})
else
    print("程序不可执行或不存在")
end

os.run

  • 安静运行原生shell命令

用于执行第三方的shell命令,但不会回显输出,仅仅在出错后,高亮输出错误信息。

此接口支持参数格式化、内置变量,例如:

lua
-- 格式化参数传入
os.run("echo hello %s!", "xmake")

-- 列举构建目录文件
os.run("ls -l $(builddir)")

注意

使用此接口执行shell命令,容易使构建跨平台性降低,对于os.run("cp ..")这种尽量使用os.cp代替 如果必须使用此接口运行shell程序,请自行使用config.plat接口判断平台支持。

os.runv

  • 安静运行原生shell命令,带参数列表

os.run类似,只是传递参数的方式是通过参数列表传递,而不是字符串命令,例如:

lua
os.runv("echo", {"hello", "xmake!"})

另外,此接口也支持envs参数设置:

lua
os.runv("echo", {"hello", "xmake!"}, {envs = {PATH = "xxx;xx", CFLAGS = "xx"}})

os.exec

  • 回显运行原生shell命令

os.run接口类似,唯一的不同是,此接口执行shell程序时,是带回显输出的,一般调试的时候用的比较多

os.execv

  • 回显运行原生shell命令,带参数列表

os.exec类似,只是传递参数的方式是通过参数列表传递,而不是字符串命令,例如:

lua
os.execv("echo", {"hello", "xmake!"})

另外,此接口还支持一个可选的参数,用于传递设置:重定向输出,执行环境变量设置,例如:

lua
os.execv("echo", {"hello", "xmake!"}, {stdout = outfile, stderr = errfile, envs = {PATH = "xxx;xx", CFLAGS = "xx"}}

其中,stdout 和 stderr 参数用于传递重定向输出和错误输出,可以直接传入文件路径,也可以传入 io.open 打开的文件对象。

v2.5.1 之后的版本,我们还支持设置 stdin 参数,来支持重定向输入文件。

注意

stdout/stderr/stdin 可以同时支持:文件路径、文件对象、管道对象等三种类型值。

重定向到文件

lua
-- 重定向输出到文件
os.execv("echo", {"hello"}, {stdout = "output.txt"})

-- 使用文件对象
local outfile = io.open("output.txt", "w")
os.execv("echo", {"hello"}, {stdout = outfile})
outfile:close()

重定向到管道

配合 pipe 模块,可以捕获子进程的输出进行处理:

lua
import("core.base.pipe")
import("core.base.bytes")

-- 创建管道
local rpipe, wpipe = pipe.openpair()

-- 将子进程 stdout 重定向到管道
os.execv("ls", {"-l"}, {stdout = wpipe})

-- 关闭写端,读取输出
wpipe:close()
local buff = bytes(8192)
local read, data = rpipe:read(buff, 8192)
if read > 0 then
    print("命令输出:", data:str())
end
rpipe:close()

同时重定向 stdout 和 stderr:

lua
import("core.base.pipe")
import("core.base.bytes")

local rpipe_out, wpipe_out = pipe.openpair()
local rpipe_err, wpipe_err = pipe.openpair()

-- 分别重定向标准输出和错误输出
os.execv("make", {}, {stdout = wpipe_out, stderr = wpipe_err})

wpipe_out:close()
wpipe_err:close()

-- 读取标准输出
local buff = bytes(8192)
local read, output = rpipe_out:read(buff, 8192)
print("标准输出:", output and output:str() or "")

-- 读取错误输出  
local read, errors = rpipe_err:read(buff, 8192)
print("错误输出:", errors and errors:str() or "")

rpipe_out:close()
rpipe_err:close()

另外,如果想在这次执行中临时设置和改写一些环境变量,可以传递envs参数,里面的环境变量设置会替换已有的设置,但是不影响外层的执行环境,只影响当前命令。

我们也可以通过os.getenvs()接口获取当前所有的环境变量,然后改写部分后传入envs参数。

os.iorun

  • 安静运行原生shell命令并获取输出内容

os.run接口类似,唯一的不同是,此接口执行shell程序后,会获取shell程序的执行结果,相当于重定向输出。

可同时获取stdout, stderr中的内容,例如:

lua
local outdata, errdata = os.iorun("echo hello xmake!")

os.iorunv

  • 安静运行原生shell命令并获取输出内容,带参数列表

os.iorun类似,只是传递参数的方式是通过参数列表传递,而不是字符串命令,例如:

lua
local outdata, errdata = os.iorunv("echo", {"hello", "xmake!"})

另外,此接口也支持envs参数设置:

lua
local outdata, errdata = os.iorunv("echo", {"hello", "xmake!"}, {envs = {PATH = "xxx;xx", CFLAGS = "xx"}}

os.getenv

  • 获取系统环境变量
lua
local value = os.getenv("PATH")

获取指定环境变量的值。如果环境变量不存在,返回 nil。

lua
local path = os.getenv("PATH")
if path then
    print("PATH:", path)
end

-- 获取带默认值的环境变量
local home = os.getenv("HOME") or "/tmp"

os.setenv

  • 设置系统环境变量
lua
os.setenv("HOME", "/tmp/")

设置指定环境变量的值。设置后会影响当前进程及其子进程的环境变量。

lua
-- 设置环境变量
os.setenv("MY_VAR", "my_value")
print(os.getenv("MY_VAR"))  -- 输出: my_value

-- 设置 PATH
os.setenv("PATH", "/new/path:" .. os.getenv("PATH"))

os.tmpdir

  • 获取临时目录

$(tmpdir)结果一致,只不过是直接获取返回一个变量,可以用后续字符串维护。

lua
print(path.join(os.tmpdir(), "file.txt"))

等价于:

lua
print("$(tmpdir)/file.txt")

os.tmpfile

  • 获取临时文件路径
lua
local tmpfile = os.tmpfile()

生成一个唯一的临时文件路径,返回的仅是路径字符串,文件本身不会自动创建,需要自己创建。

每次调用都会生成不同的临时文件路径,适合用于创建临时文件:

lua
-- 生成临时文件路径
local tmpfile = os.tmpfile()
print("临时文件:", tmpfile)  -- 例如: /tmp/xmake_XXXXXX

-- 创建并使用临时文件
io.writefile(tmpfile, "temporary data")
-- 使用完后删除
os.rm(tmpfile)

os.curdir

  • 获取当前目录路径

$(curdir)结果一致,只不过是直接获取返回一个变量,可以用后续字符串维护。

用法参考:os.tmpdir

os.filesize

  • 获取文件大小
lua
local size = os.filesize("/tmp/a")

返回文件的大小(字节数)。如果文件不存在或无法访问,返回 0。

实用示例:

lua
local size = os.filesize("build/output.bin")
if size > 0 then
    print(string.format("文件大小: %.2f KB", size / 1024))
end

-- 检查文件是否为空
if os.filesize("config.txt") == 0 then
    print("配置文件为空")
end

os.scriptdir

  • 获取当前描述脚本的路径

$(scriptdir)结果一致,只不过是直接获取返回一个变量,可以用后续字符串维护。

用法参考:os.tmpdir

os.programdir

  • 获取xmake安装主程序脚本目录

$(programdir)结果一致,只不过是直接获取返回一个变量,可以用后续字符串维护。

os.programfile

  • 获取xmake可执行文件路径
lua
local xmake_path = os.programfile()

返回 xmake 可执行文件的完整路径。

lua
print("xmake 路径:", os.programfile())
-- 例如: /usr/local/bin/xmake

os.projectdir

  • 获取工程主目录

$(projectdir)结果一致,只不过是直接获取返回一个变量,可以用后续字符串维护。

os.arch

  • 获取当前系统架构
lua
local arch = os.arch()

返回当前主机系统的默认架构。例如在 linux x86_64 上执行 xmake 进行构建,返回值是:x86_64

常见架构值:x86_64i386arm64armv7mips 等。

lua
print("当前架构:", os.arch())

-- 根据架构执行不同的操作
if os.arch() == "x86_64" then
    add_defines("ARCH_X64")
end

os.host

  • 获取当前主机的操作系统
lua
local host = os.host()

$(host) 结果一致。例如在 linux x86_64 上执行 xmake 进行构建,返回值是:linux

常见系统值:linuxmacosxwindowsbsd 等。

lua
print("当前系统:", os.host())

-- 根据系统执行不同的操作
if os.host() == "windows" then
    add_defines("WINDOWS")
elseif os.host() == "linux" then
    add_defines("LINUX")
end

os.subhost

  • 获取当前子系统
lua
local subhost = os.subhost()

获取当前子系统环境,如:在 Windows 上的 msys、cygwin 等。

如果不在子系统环境中运行,返回值与 os.host() 相同。

lua
-- 在 MSYS2 环境中
print(os.subhost())  -- 返回: msys

-- 检测是否在子系统环境中
if os.subhost() ~= os.host() then
    print("在子系统环境中运行")
end

os.subarch

  • 获取子系统架构
lua
local subarch = os.subarch()

获取子系统的架构。如果不在子系统环境中运行,返回值与 os.arch() 相同。

os.is_host

  • 判断给定系统是否为当前系统
lua
if os.is_host("linux") then
    -- 在 Linux 系统上
end

if os.is_host("macosx", "linux") then
    -- 在 macOS 或 Linux 系统上
end

支持同时判断多个系统,只要匹配其中一个就返回 true。

提示

推荐使用更简洁的内置接口 is_host(),无需 os. 前缀,用法一致:

lua
if is_host("linux") then
    -- 在 Linux 系统上
end

os.is_arch

  • 判断给定架构是否为当前架构
lua
if os.is_arch("x86_64") then
    -- 在 x86_64 架构上
end

if os.is_arch("x86_64", "arm64") then
    -- 在 x86_64 或 arm64 架构上
end

支持同时判断多个架构。

os.is_subhost

  • 判断给定子系统是否为当前子系统
lua
if os.is_subhost("msys") then
    -- 在 MSYS 子系统中
end

用于检测是否运行在特定的子系统环境中,如 msys、cygwin 等。

提示

推荐使用更简洁的内置接口 is_subhost(),用法一致。

os.is_subarch

  • 判断给定子系统架构是否为当前子系统架构
lua
if os.is_subarch("x86_64") then
    -- 子系统架构是 x86_64
end

os.ln

  • 为一个文件或目录创建符号链接
lua
-- 创建一个指向 "tmp.txt" 文件的符号链接 "tmp.txt.ln"
os.ln("xxx.txt", "xxx.txt.ln")
  • 读取符号链接内容
lua
local target = os.readlink("path/to/symlink")

读取符号链接指向的目标路径。如果指定的路径不是符号链接,则返回 nil。

配合 os.lnos.islink 使用:

lua
os.ln("source.txt", "link.txt")
if os.islink("link.txt") then
    local target = os.readlink("link.txt")
    print("链接指向:", target)  -- 输出: source.txt
end

os.raise

  • 抛出一个异常并且中止当前脚本运行
lua
-- 抛出一个带 "an error occurred" 信息的异常
os.raise("an error occurred")

注意

推荐使用与 os.raise 等价的内置接口 raise,用法与 os.raise 一致

os.raiselevel

  • os.raise 类似但是可以指定异常等级
lua
-- 抛出一个带 "an error occurred" 信息的异常
os.raiselevel(3, "an error occurred")

os.features

  • 获取系统特性
lua
local features = os.features()

获取当前操作系统支持的特性列表。返回一个 table,包含系统支持的各种特性。

os.getenvs

  • 获取所有当前系统变量
lua
local envs = os.getenvs()
-- home directory (on linux)
print(envs["HOME"])

os.setenvs

  • 使用给定系统变量替换当前所有系统变量,并返回旧系统变量

os.addenvs

  • 向当前系统变量添加新变量,并且返回所有旧系统变量
lua
os.setenvs({EXAMPLE = "a/path"}) -- add a custom variable to see addenvs impact on it

local oldenvs = os.addenvs({EXAMPLE = "some/path/"})
print(os.getenvs()["EXAMPLE"]) --got some/path/;a/path
print(oldenvs["EXAMPLE"]) -- got a/path

os.joinenvs

  • 拼接系统变量,与 os.addenvs 类似,但是不会对当前环境变量产生影响,若第二个参数为 nil,则使用原有环境变量
lua
-- os.joinenvs(envs, oldenvs)
--
-- @param envs      table 类型,新插入的环境变量
--
-- @param oldenvs   table 类型,被插入的环境变量,若为 nil, 则为原有环境变量
--
-- @return          table 类型,拼接后的环境变量
local envs0 = {CUSTOM = "a/path"}
local envs1 = {CUSTOM = "some/path/"}
print(os.joinenvs(envs0, envs1)) -- result is : { CUSTION = "a/path;some/path/" }

os.addenv

  • 向指定环境变量添加值
lua
os.addenv("PATH", "/new/path")

向指定的环境变量追加新值,使用系统默认的分隔符(Unix 上是 :,Windows 上是 ;)。

lua
-- 向 PATH 添加新路径
os.addenv("PATH", "/usr/local/bin")

-- 验证
print(os.getenv("PATH"))  -- 新路径会被追加到现有 PATH 中

os.setenvp

  • 使用给定分隔符设置环境变量
lua
os.setenvp("VAR", "value", "separator")

设置环境变量,使用指定的分隔符。与 os.setenv 类似,但可以自定义分隔符。

os.addenvp

  • 使用给定分隔符向环境变量添加值
lua
os.addenvp("VAR", "value", "separator")

向环境变量追加值,使用指定的分隔符。与 os.addenv 类似,但可以自定义分隔符。

os.workingdir

  • 获取工作目录
lua
local workdir = os.workingdir()

获取当前工作目录的绝对路径。与 os.curdir() 类似,但返回的是工作目录而不是当前脚本执行目录。

lua
print("工作目录:", os.workingdir())

os.isroot

  • 判断xmake是否以管理员权限运行
lua
if os.isroot() then
    print("以管理员权限运行")
end

在 Unix 系统上检查是否以 root 用户运行,在 Windows 上检查是否以管理员权限运行。

某些操作需要管理员权限时很有用:

lua
if not os.isroot() then
    raise("此操作需要管理员权限,请使用 sudo 或以管理员身份运行")
end

os.fscase

  • 判断操作系统的文件系统是否大小写敏感
lua
if os.fscase() then
    print("文件系统区分大小写")
else
    print("文件系统不区分大小写")
end

返回 true 表示文件系统区分大小写(如 Linux),false 表示不区分(如 Windows、macOS 默认)。

用于处理跨平台的文件名兼容性:

lua
if not os.fscase() then
    -- 在不区分大小写的系统上,避免使用仅大小写不同的文件名
    print("警告: 文件系统不区分大小写")
end

os.term

  • 获取当前终端 (windows-terminal, vscode, xterm, ...)

os.shell

  • 获取当前shell (pwsh, cmd, bash, zsh, ...)

os.cpuinfo

  • 获取当前CPU信息
lua
print(os.cpuinfo())
-- probably got {
--   march = "Alder Lake",
--   model = 154,
--   ncpu = 20,
--   model_name = "12th Gen Intel(R) Core(TM) i9-12900H",
--   usagerate = 0.041839182376862,
--   vendor = "GenuineIntel",
--   family = 6
-- }
print(os.cpuinfo("march")) -- probably got "Alder Lake"

os.meminfo

  • 获取内存信息
lua
print(os.meminfo())
-- probably got {
--   pagesize = 4096,
--   usagerate = 0.60694103194103,
--   availsize = 12798,
--   totalsize = 32560
-- }
print(os.meminfo("pagesize")) -- probably got 4096

os.default_njob

  • 获取默认编译任务数

返回默认的并行编译任务数,通常等于 CPU 核心数。

lua
local njob = os.default_njob()
print("默认并行任务数:", njob)

os.argv

  • 将命令行字符串解析为参数列表
lua
local args = os.argv("gcc -o test test.c -I/usr/include")

将命令行字符串解析为参数数组,支持引号、转义字符等复杂格式。

解析规则:

  • 支持双引号和单引号包裹参数
  • 支持转义字符(\
  • 自动处理空格分隔
  • 处理特殊字符如括号、反斜杠等

示例:

lua
-- 简单参数
os.argv("aa bb cc")  -- 返回: {"aa", "bb", "cc"}

-- 带引号的参数
os.argv('"aa bb cc" dd')  -- 返回: {"aa bb cc", "dd"}

-- 带等号的参数
os.argv("--bb=bbb -c")  -- 返回: {"--bb=bbb", "-c"}

-- 转义引号
os.argv('-DTEST=\\"hello\\"')  -- 返回: {'-DTEST="hello"'}

-- 复杂参数
os.argv('-DTEST="hello world"')  -- 返回: {'-DTEST=hello world'}

支持 splitonly 选项仅分割不处理引号:

lua
os.argv('-DTEST="hello world"', {splitonly = true})  -- 返回: {'-DTEST="hello world"'}

os.args

  • 将参数列表转换为命令行字符串
lua
local cmdline = os.args({"gcc", "-o", "test", "test.c"})

将参数数组转换为命令行字符串,是 os.argv 的逆操作。

自动处理特殊字符:

  • 含有空格的参数会自动加引号
  • 自动转义特殊字符
  • 处理路径中的反斜杠

示例:

lua
-- 简单参数
os.args({"aa", "bb", "cc"})  -- 返回: "aa bb cc"

-- 含空格的参数
os.args({"aa bb cc", "dd"})  -- 返回: '"aa bb cc" dd'

-- 带引号的参数
os.args({'-DTEST="hello"'})  -- 返回: '-DTEST=\\"hello\\"'

-- 路径参数
os.args({"aa\\bb/cc dd", "ee"})  -- 返回: '"aa\\\\bb/cc dd" ee'

支持 escape 选项启用额外的转义:

lua
os.args({"aa\\bb/cc", "dd"}, {escape = true})  -- 返回: "aa\\\\bb/cc dd"

配合 os.argv 进行往返转换:

lua
local cmdline = "gcc -o test test.c"
local args = os.argv(cmdline)
local cmdline2 = os.args(args)
-- cmdline2 应该与 cmdline 等价

os.mclock

  • 获取单调时钟时间(毫秒)
lua
local start = os.mclock()
-- 执行一些操作
local elapsed = os.mclock() - start
print("耗时:", elapsed, "ms")

返回单调递增的时间戳(毫秒),适合用于测量时间间隔。

os.clock() 不同,os.mclock() 返回的是单调时钟,不受系统时间调整的影响,更适合用于性能测量:

lua
local function benchmark(func)
    local start = os.mclock()
    func()
    local elapsed = os.mclock() - start
    print(string.format("执行耗时: %.2f ms", elapsed))
end

benchmark(function()
    os.sleep(100)
end)