os.Mkdir 是跨平台、类型安全的高层封装，而 syscall.Mkdir 是直连内核的底层系统调用，具备平台特性和更高灵活性，但牺牲可移植性与抽象安全性。
`os.mkdir` 是跨平台、类型安全的高层封装，而 `syscall.mkdir` 是直连内核的底层系统调用，具备平台特性和更高灵活性，但牺牲可移植性与抽象安全性。
在 Go 语言的标准库中，目录创建看似简单，实则存在两套语义与职责截然不同的 API：os.Mkdir（位于 os 包）和 syscall.Mkdir（位于 syscall 包）。尽管二者函数签名高度相似，且最终都触发 Linux 的 mkdir(2) 系统调用，但它们在设计目标、使用场景与工程权衡上存在本质区别。
? os.Mkdir：面向应用开发者的可移植接口
os.Mkdir 是 Go 标准库为开发者提供的跨平台、类型安全、语义明确的目录创建函数：
func Mkdir(name string, perm FileMode) error
- perm 类型为 os.FileMode（本质是 uint32 的别名），但封装了权限位的语义（如 0755、0700），并自动处理平台差异（例如 Windows 忽略执行位，Unix 保留 sticky/setgid 位）；
- 内部会进行路径合法性校验、错误码标准化（统一返回 *os.PathError）、自动处理空路径/相对路径等边界情况；
- 兼容所有 Go 支持的 OS（Linux、macOS、Windows、FreeBSD 等），行为一致——这是其核心价值。
✅ 推荐用于绝大多数业务代码，尤其强调可维护性与跨平台部署的场景。
? syscall.Mkdir：面向系统编程的裸金属调用
syscall.Mkdir 提供的是对操作系统原生 mkdir(2) 系统调用的最小封装：
func Mkdir(path string, mode uint32) (err error)
- mode 是原始 uint32，需开发者手动构造权限掩码（如 0o755 或 0755），且完全暴露平台细节：
- 在 Linux 上，可精确设置 sticky bit（01000）、setgid（02000）等特权位；
- 在 Windows 上，该参数被忽略（无意义），但调用仍成功；
- 不做路径预处理（如不自动展开 ~ 或处理 ..），也不转换错误为 Go 标准错误类型（直接返回 errno 对应的 syscall.Errno）；
- 属于 syscall 包——该包已被官方标记为 “low-level, not portable, subject to change”，不建议在常规应用中直接使用。
⚠️ 仅适用于需精细控制内核行为的场景，例如：
- 编写兼容特定 Unix 权限策略的文件系统工具；
- 实现自定义挂载点权限初始化逻辑；
- 构建容器运行时或内核调试辅助工具。
? 关键对比总结
| 维度 | os.Mkdir | syscall.Mkdir |
|---|---|---|
| 抽象层级 | 高层封装（POSIX 语义 + Go 习惯） | 底层直调（接近 C 的 mkdir(2)） |
| 可移植性 | ✅ 全平台行为一致 | ❌ Linux/macOS 有效，Windows 降级处理 |
| 类型安全 | ✅ FileMode 类型约束 + 权限校验 | ❌ uint32 原始值，易误传非法掩码 |
| 错误处理 | ✅ 统一 *os.PathError，含路径上下文 | ❌ 原始 syscall.Errno，需手动映射 |
| 适用场景 | 应用开发、脚本、通用工具 | 系统编程、内核交互、性能敏感底层模块 |
? 最佳实践建议
- 默认选择 os.Mkdir：它已足够高效（内部仍调用 syscall.Mkdir），且避免了平台陷阱；
- 若需设置 sticky bit（如 /tmp 目录），可安全使用 os.Mkdir 并传入 01777（Go 1.16+ 支持完整 POSIX 权限位）；
- 仅当 os 包无法满足需求（如需绕过 Go 运行时路径规范化、或对接非标准内核扩展）时，才谨慎引入 syscall.Mkdir，并务必添加平台构建约束（如 //go:build linux）。
简言之：os.Mkdir 是你日常驾驶的自动挡轿车——安全、省心、适应各种路况；syscall.Mkdir 则是拆掉外壳的发动机——动力直接，但需要懂原理、会保养，且只在特定赛道上发挥优势。
