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

在 Go 语言中,创建文件和目录主要依靠 os 包提供的函数,核心是 os.Create 和 os.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() // 记得关闭
立即学习“go语言免费学习笔记(深入)”;
使用 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.Create或os.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 包使用更健壮。









