操作系统函数 on Hugo 中文文档

os.FileExists

Fri, 02 Oct 2026 00:00:00 +0800

os.FileExists 函数先尝试相对于项目目录的根解析路径。如果找不到匹配的文件或目录，它会尝试相对于 contentDir 解析路径。路径开头的分隔符（/）是可选的。

目录结构如下：

content/
├── about.md
├── contact.md
└── news/
    ├── article-1.md
    └── article-2.md

该函数返回以下值：

os.Getenv

Fri, 02 Oct 2026 00:00:00 +0800

安全性

默认情况下，使用 os.Getenv 函数时 Hugo 允许访问：

CI 环境变量
任何以 HUGO_ 开头的环境变量

要访问其它环境变量，请调整项目配置。例如，允许访问 HOME 与 USER 环境变量：

[security.funcs]
getenv = ['^HUGO_', '^CI$', '^USER$', '^HOME$']

更多信息请参见配置安全性。

示例

{{ getenv "HOME" }} → /home/victor
{{ getenv "USER" }} → victor

构建项目时可以传入值：

os.ReadDir

Fri, 02 Oct 2026 00:00:00 +0800

os.ReadDir 函数相对于项目目录的根解析路径。路径开头的分隔符（/）是可选的。

目录结构如下：

content/
├── about.md
├── contact.md
└── news/
    ├── article-1.md
    └── article-2.md

以下模板代码：

os.ReadFile

Fri, 02 Oct 2026 00:00:00 +0800

os.ReadFile 函数先尝试相对于项目目录的根解析路径。如果找不到匹配的文件，它会尝试相对于 contentDir 解析路径。路径开头的分隔符（/）是可选的。

假设项目目录根下有一个名为 README.md 的文件：

os.Stat

Fri, 02 Oct 2026 00:00:00 +0800

os.Stat 函数先尝试相对于项目目录的根解析路径。如果找不到匹配的文件或目录，它会尝试相对于 contentDir 解析路径。路径开头的分隔符（/）是可选的。

{{ $f := os.Stat "README.md" }}
{{ $f.IsDir }}    → false (bool)
{{ $f.ModTime }}  → 2021-11-25 10:06:49.315429236 -0800 PST (time.Time)
{{ $f.Name }}     → README.md (string)
{{ $f.Size }}     → 241 (int64)

{{ $d := os.Stat "content" }}
{{ $d.IsDir }}    → true (bool)

FileInfo 结构的详细信息见 Go 文档。