Linux mkdir函数是文件操作系统中用于创建目录的核心系统调用，广泛应用于Shell脚本编程、系统管理及应用程序开发中，本文将从函数原型、参数说明、使用示例、错误处理、权限控制及实际应用场景六个方面，详细解析该函数的功能与使用方法。
函数原型与头文件
Linux mkdir函数的原型定义在sys/stat.h和sys/types.h头文件中，其标准形式为：
int mkdir(const char *pathname, mode_t mode);
pathname参数指定要创建的目录路径，可以是绝对路径（如/home/user/docs）或相对路径（如./docs）；mode参数用于设置目录的初始权限，通常使用八进制表示（如0755），函数执行成功时返回0，失败则返回-1并设置errno以指示错误类型。
参数详解
pathname参数需满足文件系统命名规范，不能包含、或等特殊字符（除非作为路径分隔符），若路径中的中间目录不存在，mkdir默认不会自动创建父目录，此时需配合mkdir -p（在命令行中）或mkdir_p函数（在编程中）使用。mode参数的有效取值范围受系统umask值影响，实际权限计算公式为mode & ~umask，设置mode=0777且umask=0022时，目录最终权限为0755。
基本使用示例
以下是一个简单的C语言示例,演示如何使用mkdir创建目录：
#include <sys/stat.h>
#include <sys/types.h>
#include <stdio.h>
#include <errno.h>
int main() {
const char *dir_path = "./new_directory";
mode_t dir_mode = 0755;
if (mkdir(dir_path, dir_mode) == -1) {
perror("mkdir failed");
return 1;
}
printf("Directory created successfully: %s\n", dir_path);
return 0;
}
编译并运行此程序后,将在当前工作目录下创建权限为rwxr-xr-x的new_directory目录。
错误处理机制
当mkdir失败时，需通过errno变量定位具体原因，常见的错误类型包括：
EEXIST：目录已存在（文件或同名目录冲突）。EACCES：权限不足（如父目录无写入权限）。ENOENT：路径中的父目录不存在。ENOSPC：磁盘空间不足。
建议在调用mkdir后检查返回值，并通过perror()或strerror(errno)输出错误信息，
if (mkdir(dir_path, mode) == -1) {
if (errno == EEXIST) {
fprintf(stderr, "Error: Directory already exists.\n");
} else {
perror("mkdir error");
}
}
权限控制与umask
mode参数的设置需结合系统umask值。umask是文件创建时默认屏蔽的权限位，可通过umask()函数修改。
umask(0002); // 设置umask为0002，新目录权限计算为mode & ~0002
mkdir("test_dir", 0777); // 实际权限为0775
在多用户系统中,建议显式设置mode并考虑umask的影响，避免权限意外过松或过紧。
实际应用场景
mkdir函数在多个领域具有重要应用：
- Shell脚本自动化：批量创建项目目录结构，如
mkdir -p project/{src,bin,doc}。 - 应用程序初始化：软件首次运行时创建配置目录（如
~/.config/appname）。 - 临时文件管理：生成唯一命名的临时目录（结合
mktemp函数）。 - 容器化环境：在Docker或Podman中为容器挂载点创建目录。
以下是一个递归创建目录的函数实现,弥补mkdir不自动创建父目录的不足：
#include <string.h>
#include <unistd.h>
int mkdir_p(const char *path, mode_t mode) {
char tmp[256];
char *p = NULL;
size_t len;
strncpy(tmp, path, sizeof(tmp));
len = strlen(tmp);
if (tmp[len - 1] == '/') {
tmp[len - 1] = 0;
}
for (p = tmp + 1; *p; p++) {
if (*p == '/') {
*p = 0;
mkdir(tmp, mode);
*p = '/';
}
}
return mkdir(tmp, mode);
}
Linux mkdir函数作为目录创建的基础工具，其简洁的设计与灵活的参数使其成为系统编程的重要组成部分，理解其原型、权限机制及错误处理方法，能够帮助开发者更高效地管理文件系统结构，在实际开发中，需结合umask、路径合法性检查及递归创建逻辑，确保目录创建的健壮性与安全性，通过合理运用mkdir函数，可以显著提升脚本和应用程序的自动化管理能力。
