如何使用Golang创建文件与目录_Golang os Create与Mkdir方法说明

Go中创建文件用os.Create(清空重写,不建父目录),创建单层目录用os.Mkdir(父目录须存在),嵌套目录用os.MkdirAll(自动递归创建);均需检查错误并合理设置权限。

在 Go 语言中,创建文件和目录主要依靠 os 包提供的函数,核心是 os.Createos.Mkdir(及其变体)。它们底层调用系统 API,行为跨平台一致,但需注意错误处理与路径语义。

使用 os.Create 创建文件

os.Create 会创建一个新文件,如果文件已存在,则清空内容并重写(等价于以 O_TRUNC | O_CREATE | O_WRONLY 标志打开)。它返回一个 *os.File 句柄和可能的错误。

  • 若父目录不存在,Create 会失败(不会自动创建上级目录)
  • 创建成功后,文件权限默认为 0666,受 umask 影响,通常表现为 0644
  • 务必检查返回的 error,常见错误包括:路径含非法字符、磁盘满、无写入权限等

示例:

f, err := os.Create("data.txt")
if err != nil {
  log.Fatal(err)
}
defer f.Close() // 记得关闭

使用 os.Mkdir 创建单层目录

os.Mkdir 仅创建最末一级目录,要求其父目录必须已存在。第二个参数指定权限(如 0755),Windows 上权限位会被忽略。

  • 若目标目录已存在,返回 os.ErrExist 错误(不是致命错误,可按需忽略或跳过)
  • 权限值建议用八进制字面量(如 0755),避免十进制混淆
  • 不支持递归创建多级缺失路径

示例:

err := os.Mkdir("logs", 0755)
if err != nil && !os.IsExist(err) {
  log.Fatal(err)
}

使用 os.MkdirAll 创建嵌套目录

多数场景推荐用 os.MkdirAll —— 它能自动逐级创建所有缺失的父目录,类似 shell 中的 mkdir -p

  • 如果最终目录已存在,不会报错,直接返回 nil
  • 中间某级目录权限由实际创建时传入的 perm 决定,而非继承上级
  • 适合初始化日志目录、缓存路径、配置目录等不确定是否存在的结构

示例:

err := os.MkdirAll("tmp/cache/images", 0755)
if err != nil {
  log.Fatal(err)
}

组合使用:先建目录再建文件

典型流程是先确保路径存在,再创建文件。可封装成简洁逻辑:

  • 提取文件所在目录(用 filepath.Dir
  • 调用 os.MkdirAll 创建完整路径
  • 再用 os.Createos.OpenFile 写入内容

示例:

path := "output/reports/report.json"
if err := os.MkdirAll(filepath.Dir(path), 0755); err != nil {
  log.Fatal(err)
}
f, err := os.Create(path)
if err != nil {
  log.Fatal(err)
}
defer f.Close()

基本上就这些。关键点在于:Create 不建目录,Mkdir 不递归,MkdirAll 最省心;权限和错误检查不能少;路径操作建议搭配 filepath 包使用更健壮。