Go 创建文件夹

在程序里整理日志、导出报表或存放缓存时,我们经常需要先建好对应的文件夹(也叫 “目录”)。Go 语言标准库 os 包提供了两个常用的创建函数:一个是创建单层文件夹的 os.Mkdir(),另一个是一次性递归创建多层文件夹的 os.MkdirAll()。

其中,mkdir 是 “make directory(创建目录)” 的缩写,和我们在命令行终端里使用的 mkdir 命令同名。下面我们就来看看这两个函数的具体用法与区别。

os.Mkdir() 创建单层文件夹

如果我们只需要在已有的目录下新建一层文件夹,可以使用 os.Mkdir() 函数。

语法:

err := os.Mkdir(name, perm)

说明:

os.Mkdir() 接收以下 2 个参数,并返回一个 error 错误值:

  • name(必选):要创建的文件夹路径。os.Mkdir() 要求前面的上级父目录必须已经存在。如果目标文件夹本身已经存在,它也会直接返回错误。
  • perm(必选):文件夹的权限编码,日常开发中一般固定填写 0755;标准库也提供了常量 os.ModePerm(即 0777),但它在 Linux 下会放开所有人的写入权限,正式项目里还是填 0755 更安全。

为什么前面写入文件时权限填 0644,这里创建文件夹却要填 0755 呢?因为在 Linux 和 macOS 中,文件夹必须带有可执行权限(值为 1)才能打开进入,在 0644 每一位上加 1 就是 0755。Windows 系统会忽略该权限码,小伙伴们平时直接填 0755 就可以了。

示例 1:创建单层文件夹

package main

import (
    "fmt"
    "os"
)

func main() {
    // 第 1 次创建单层文件夹 logs
    err := os.Mkdir("logs", 0755)
    if err != nil {
        fmt.Println("创建失败:", err)
        return
    }
    fmt.Println("文件夹 logs 创建成功")

    // 再次创建同名文件夹
    err = os.Mkdir("logs", 0755)
    if err != nil {
        fmt.Printf("再次创建失败:%v\n", err)
    }
}

运行结果如下。

文件夹 logs 创建成功
再次创建失败:mkdir logs: file exists

分析:

上面代码连续调用了两次 os.Mkdir("logs", 0755)。当我们第 1 次调用时,当前工作目录下还没有 logs 文件夹,因此顺利创建成功。第 2 次调用时,由于 logs 已经存在,函数直接返回了 file exists(文件已存在)错误。

此外,如果上级目录 a 和 b 还没有创建,我们直接调用 os.Mkdir("a/b/c", 0755) 也会因为找不到上级目录而报错。遇到这种多层嵌套目录,小伙伴们就需要使用下面介绍的 os.MkdirAll() 函数了。

os.MkdirAll() 创建多层文件夹(推荐)

os.Mkdir() 就像终端里普通的 mkdir 命令,而 os.MkdirAll() 则相当于加上了 -p 参数的 mkdir -p 命令。它会从左往右逐层检查路径,只要哪一层目录不存在,就自动帮我们把它建好。

语法:

err := os.MkdirAll(path, perm)

说明:

os.MkdirAll() 同样接收文件夹路径 path 和权限码 perm 两个参数。如果路径中的上级父目录不存在,它会连同所有缺失的父目录一起递归创建出来。同时,如果目标文件夹原本就已经存在,os.MkdirAll() 不会报错,而是直接返回 nil。

组合多层目录路径时,我们可以配合 filepath.Join() 自动适配不同系统的路径分隔符。下面我们来看一个例子。

示例 2:创建多层嵌套文件夹

package main

import (
    "fmt"
    "os"
    "path/filepath"
)

func main() {
    // 拼接跨平台的多层目录路径
    dirPath := filepath.Join("data", "2026", "reports")

    // 一次性创建多层嵌套文件夹
    err := os.MkdirAll(dirPath, 0755)
    if err != nil {
        fmt.Println("创建失败:", err)
        return
    }
    fmt.Println("第 1 次创建多层文件夹成功")

    // 对已存在的文件夹再次调用
    err = os.MkdirAll(dirPath, 0755)
    if err == nil {
        fmt.Println("第 2 次调用依然成功,不会报错")
    }
}

运行结果如下。

第 1 次创建多层文件夹成功
第 2 次调用依然成功,不会报错

分析:

在这个例子中,我们先通过 filepath.Join() 拼接出跨平台目录路径。随后 os.MkdirAll(dirPath, 0755) 从外层的 data 一直到里层的 reports,把沿途不存在的 3 层目录一次性全部建好。

紧接着我们对已经建好的 dirPath 第 2 次调用 os.MkdirAll(),返回结果依然是 nil,不会像 os.Mkdir() 那样触发文件已存在的错误。

前面学习写入文件时我们提到过,如果目标路径里的上级文件夹还不存在,直接调用 os.WriteFile() 会报错失败。那么在写文件之前,怎么自动确保它的上级目录一定存在呢?实际开发中最常用的组合套路,就是先用 filepath.Dir() 取出父目录,再交给 os.MkdirAll() 创建出来。

示例 3:写文件前先确保父目录存在

package main

import (
    "fmt"
    "os"
    "path/filepath"
)

func main() {
    filePath := filepath.Join("output", "logs", "app.log")

    // 1. 提取文件所在的父目录并自动创建
    parentDir := filepath.Dir(filePath)
    if err := os.MkdirAll(parentDir, 0755); err != nil {
        fmt.Println("创建目录失败:", err)
        return
    }

    // 2. 目录就位后再写入文件
    err := os.WriteFile(filePath, []byte("服务启动成功\n"), 0644)
    if err != nil {
        fmt.Println("写入文件失败:", err)
        return
    }

    fmt.Println("文件已保存到:", filePath)
}

运行结果如下。

文件已保存到:output/logs/app.log

分析:

上面代码先用 filepath.Dir(filePath) 从 "output/logs/app.log" 中提取出父目录 "output/logs"。紧接着 os.MkdirAll() 自动把缺失的两层目录建好,最后 os.WriteFile() 就能顺利写入日志,不管目录之前存不存在都不会报错。

提示: 在实际开发中,不管是创建单层文件夹还是多层文件夹,大多数场景下我们都推荐直接使用 os.MkdirAll(dirPath, 0755)。它既支持多级目录,又自带 “目录已存在时不报错” 的特性,省去了创建前先调用 os.Stat() 检查目录是否存在的步骤。

上一篇:

下一篇:

给站长反馈

绿叶网正在不断完善中,小伙伴们如果发现任何问题,还望多多给站长反馈,谢谢!

邮箱:lvyenet@vip.qq.com

「绿叶网」服务号
绿叶网服务号放大
关注服务号,微信也能看教程。
绿叶网服务号