---
url: /zh/api/scripts/builtin-modules/vformat.md
---
# vformat

* 格式化字符串，支持内置变量转义

#### 函数原型

::: tip API

```lua
vformat(formatstring: <string>, ...)
```

:::

#### 参数说明

| 参数 | 描述 |
|------|------|
| formatstring | 格式字符串 |
| ... | 格式化的可变参数 |

#### 用法说明

此接口跟[format](/api/scripts/builtin-modules/format)接口类似，只是增加对内置变量的获取和转义支持。

```lua
local s = vformat("hello %s $(mode) $(arch) $(env PATH)", xmake)
```
