登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go os.Root.Mkdir 怎样在 Root 内创建目录

来源:17golang原创

时间:2026-11-20 05:57:02 447浏览 收藏

先调用 os.OpenRoot 打开一个已存在的根目录,再调用 root.Mkdir("exports", 0o750),即可在该 Root 内创建 exports 目录。name 相对于 Root,Mkdir 返回 error,不返回目录句柄;成功返回 nil。它只创建指定的这一层,缺少父目录时不会自动补齐。

Root.Mkdir 随 Go 1.24 的 Root API 提供,使目录操作可以围绕一个明确的目录树表达。对已有代码而言,主要变化是将“先拼出完整路径,再调用全局函数”的做法,改为“持有根目录对象,再传入根内名称”。这不是要求所有代码都迁移;当程序本来就围绕一个固定工作区创建输出目录时,这样的接口更容易说明调用范围。

官方文档:https://pkg.go.dev/os#Root.Mkdir

把目录创建放进 Root 的访问范围

以导出工具为例,配置里选择 workspace 为根目录,业务任务只提出新建 exports。配置层负责 Root,业务层提供相对名称,创建函数通过 Root.Mkdir 完成操作。不要把 workspace 再拼进 name,否则会变成在根目录内部寻找另一个 workspace。

os.OpenRoot 自身不会创建根目录。根目录不存在或无法打开时,应先返回配置阶段的错误;尚未进入 Mkdir。Root 使用结束后要关闭,长期共享 Root 的程序则应在共享对象生命周期结束时统一释放。

Root.Mkdir 与根目录配置、目录名称、权限参数的静态关系
静态结构说明图:根目录对象与创建参数各有职责,连线表示关联而非执行步骤。

先明确单层创建和权限参数

输入或返回值本例约定容易混淆的地方
rootDir已经存在的工作区目录Mkdir 不替你建立 Root 对应目录
nameexports 等根内相对名称相对 Root,而不是进程工作目录
perm0o750创建前的权限请求,可能受 umask 等环境因素影响
errornil 表示创建调用成功已存在不应未经判断直接当成功

0o750 是八进制权限位写法,不是十进制 750。Root.Mkdir 只接受低九位权限位,不能额外塞入 os.ModeDir 或其他模式位。方法本身负责创建目录,调用者无需用目录类型位再次说明目标类型。

在 Unix 类系统上,umask 可以进一步去掉请求的权限位;实际访问还可能受到 ACL 等机制影响。不要用“传了 0o750”推导出所有平台都得到完全相同的授权效果,也不要为了消除报错直接放宽成 0o777。

若 name 是 reports/daily,reports 必须事先存在。递归创建属于另一种契约;Root.MkdirAll 自 Go 1.25 提供,只有明确需要递归建父目录并满足版本要求时才选择它。本文示例保持 Mkdir 的单层语义。

写一个只创建新目录的示例

下面的命令行工具只创建新目录。目标已存在时,即使它是目录,也明确返回错误,方便调用者区分“本次创建”和“复用历史对象”。保存为 main.go 即可用于已有工作区。

package main

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

// createDirectory 要求目标尚不存在,父目录已经准备好。
func createDirectory(rootDir, name string) (err error) {
 // 本例只接受本地相对路径;这不是磁盘链接检查。
 if !filepath.IsLocal(name) || filepath.Clean(name) == "." {
  return fmt.Errorf("请输入根目录内的新目录相对名称")
 }
 root, err := os.OpenRoot(rootDir)
 if err != nil {
  return fmt.Errorf("打开根目录:%w", err)
 }
 defer func() {
  // 保留创建错误,同时报告目录句柄的关闭错误。
  err = errors.Join(err, root.Close())
 }()
 // 直接尝试创建,避免先查不存在再创建的额外竞态窗口。
 if err := root.Mkdir(name, 0o750); err != nil {
  switch {
  case errors.Is(err, os.ErrExist):
   return fmt.Errorf("目标已存在,本工具不复用:%w", err)
  case errors.Is(err, os.ErrNotExist):
   return fmt.Errorf("请检查父目录是否存在:%w", err)
  case errors.Is(err, os.ErrPermission):
   return fmt.Errorf("创建目录的文件系统权限不足:%w", err)
  default:
   return fmt.Errorf("创建目录失败:%w", err)
  }
 }
 return nil
}

func main() {
 rootDir := flag.String("root", "./workspace", "已存在的根目录")
 name := flag.String("name", "exports", "需要新建的相对目录名")
 flag.Parse()
 // 函数返回后,其内部的延迟关闭已经执行。
 if err := createDirectory(*rootDir, *name); err != nil {
  fmt.Fprintln(os.Stderr, err)
  os.Exit(1)
 }
 fmt.Println("目录创建成功")
}
# workspace 必须已经存在,本次只新建其中的 exports
go run main.go -root ./workspace -name exports

示例中的 filepath.IsLocal 是附加的词法输入规则;它不会访问文件系统或判断符号链接。Root 的实际访问规则与这项输入规则分别承担职责。Root 允许符合约束的树内相对链接,不允许通过路径引用越出根目录;不要将词法清理当成实际访问机制的替代。

创建操作直接交给 Mkdir,再分类返回错误。先 Stat 判断不存在,随后 Mkdir,不能保证这两个调用之间没有别的任务创建同名对象。直接创建仍可能遇到并发竞争,但调用者可以根据本次返回错误作出明确决策。

代码通过 %w 保留底层错误,再用 errors.Is 分类。函数持有 Root,defer 合并关闭错误;main 在函数返回后决定退出码。本文没有执行示例,也不把图片中的框图作为运行结果。

创建调用的返回错误与已存在、父目录缺失、权限不足分类的静态关系
静态结构说明图:错误分类帮助调用者决定下一步,并不代表所有错误只有这几类。

旧代码迁移时保留错误语义

迁移时先确定目标是“必须新建”还是“目录存在即可”。前者可以采用本文契约,ErrExist 即失败;后者需要在 ErrExist 后额外确认已存在对象符合业务要求,不能把同名普通文件也视为有效目录。是否允许符号链接也应写入业务约定。

保留原先的错误返回路径,避免迁移后把所有失败都吞掉。父目录缺失应检查任务初始化顺序,权限不足应检查运行身份和父目录授权,Root 已关闭等其他错误应原样保留;不应在失败时退回普通 os.Mkdir 拼接路径。

读者可在自己准备的临时工作区确认三件事:首次创建得到预期目录;重复同名创建触发已存在分支;缺少父目录时触发错误而不是偷偷递归创建。目录创建成功不等于后续任务一定成功,后续文件写入仍要处理自己的错误。若创建成功但 Root.Close 报错,本例仍返回错误,已创建目录不会因此自动撤销。

Root 表达目录树访问范围,不提供整套权限隔离或事务回滚,也不阻止跨挂载点。GOOS=js 的符号链接检查存在官方说明的平台限制;在这些环境中,不应将 Root 视为无条件的文件系统沙箱。

常见问题

Mkdir 成功后需要关闭新目录吗?

Mkdir 只返回 error,没有给调用者新的目录句柄,因此没有对应的新句柄需要 Close。本例需要关闭的是 os.OpenRoot 返回的 Root。

目录已存在时能否直接忽略错误?

必须先明确业务是否允许复用,再确认现有对象类型及其他要求。本文工具选择不复用,避免把重复创建默认为成功。

为什么传入 os.ModeDir 会出错?

perm 是权限位参数,Root.Mkdir 限定低九位。目录类型由操作本身决定,无需额外添加 ModeDir。

资料依据:Go 官方 os 包的 Root、Root.Mkdir、Mkdir 与 Root.MkdirAll 文档及 Root 设计说明。完整地址可复制:

https://pkg.go.dev/os#Root

https://go.dev/blog/osroot

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>