跳至主要内容

file 函数

file 读取给定路径下文件的内容并将其作为字符串返回。

代码块
file(path)

OpenTofu 语言中的字符串是 Unicode 字符序列，因此此函数将文件内容解释为 UTF-8 编码的文本并返回生成的 Unicode 字符。如果文件包含无效的 UTF-8 序列，则此函数将产生错误。

此函数只能用于 OpenTofu 运行开始时磁盘上已存在的文件。函数不参与依赖关系图，因此此函数不能与在 OpenTofu 操作期间动态生成的 文件一起使用。我们不建议在 OpenTofu 配置中使用动态本地文件，但在极少数情况下需要这样做时，您可以使用 local_file 数据源 读取文件，同时尊重资源依赖关系。

示例​

代码块
> file("${path.module}/hello.txt")
Hello World
  • filebase64 也读取给定文件的内容，但返回该文件中 Base64 编码的原始字节，而不是将内容解释为 UTF-8 文本。
  • fileexists 确定给定路径下文件是否存在。
  • templatefile 使用磁盘上的文件作为模板进行渲染。