os.mkdir 是 Python 标准库 os 模块中的一个函数，用于在文件系统中创建目录（文件夹）。它是操作系统相关功能的一部分，允许开发者在 Python 脚本中直接与文件系统进行交互。本文将详细介绍 os.mkdir 的使用方法、参数、注意事项以及相关的扩展知识，帮助你更好地理解和使用这一函数。

1. os.mkdir 的基本用法

os.mkdir 函数的语法如下：

os.mkdir(path, mode=0o777, *, dir_fd=None) path: 要创建的目录路径，可以是*路径或相对路径。 mode: 目录的权限模式，默认值为 0o777（八进制表示），表示所有用户都有读、写和执行权限。在 Windows 系统中，mode 参数通常被忽略。 dir_fd: 可选参数，表示文件描述符，用于指定相对路径的基准目录。 示例 1：创建一个简单的目录 import os # 在当前工作目录下创建一个名为 "new_folder" 的目录 os.mkdir("new_folder") 示例 2：创建带有特定权限的目录 import os # 创建一个目录，并设置权限为只有所有者有读、写、执行权限 os.mkdir("private_folder", mode=0o700)

2. os.mkdir 的注意事项

在使用 os.mkdir 时，需要注意以下几点：

2.1 目录已存在的情况

如果尝试创建的目录已经存在，os.mkdir 会抛出 FileExistsError 异常。为了避免程序崩溃，可以在创建目录前检查其是否存在。

import os path = "new_folder" if not os.path.exists(path): os.mkdir(path) else: print(f"目录 {path} 已存在") 2.2 父目录不存在的情况

os.mkdir 只能创建单层目录。如果指定的路径中包含不存在的父目录，会抛出 FileNotFoundError 异常。如果需要创建多层目录，可以使用 os.makedirs 函数。

import os # 创建多层目录 os.makedirs("parent_folder/child_folder/grandchild_folder") 2.3 权限问题

在某些操作系统中，如果没有足够的权限在指定路径下创建目录，os.mkdir 会抛出 PermissionError 异常。确保程序运行的用户具有足够的权限。

2.4 路径格式

路径可以是*路径（如 /home/user/new_folder）或相对路径（如 ./new_folder）。在 Windows 系统中，路径分隔符可以是反斜杠 ，但在 Python 中建议使用正斜杠 /，或者使用 os.path.join 来构建路径。

import os # 使用 os.path.join 构建路径 path = os.path.join("parent_folder", "child_folder") os.mkdir(path)

3. os.mkdir 的扩展知识

3.1 os.makedirs 函数

os.makedirs 是 os.mkdir 的增强版，用于递归创建多层目录。它的语法与 os.mkdir 类似，但会自动创建所有缺失的父目录。

import os # 递归创建多层目录 os.makedirs("path/to/new/folder") 3.2 exist_ok 参数

在 Python 3.2 及以上版本中，os.makedirs 支持 exist_ok 参数。如果设置为 True，当目录已存在时不会抛出异常。

import os # 如果目录已存在，不会抛出异常 os.makedirs("existing_folder", exist_ok=True) 3.3 跨平台路径处理

为了确保代码在不同操作系统上都能正常运行，建议使用 os.path 模块中的函数来处理路径。例如：

os.path.join: 拼接路径。 os.path.abspath: 获取*路径。 os.path.normpath: 规范化路径。 import os # 跨平台路径处理 path = os.path.join("folder1", "folder2", "file.txt") normalized_path = os.path.normpath(path) print(normalized_path) 3.4 错误处理

在实际开发中，建议对 os.mkdir 的调用进行错误处理，以应对各种可能的异常情况。

import os try: os.mkdir("new_folder") except FileExistsError: print("目录已存在") except PermissionError: print("权限不足") except OSError as e: print(f"创建目录时发生错误: {e}")

4. 实际应用场景

os.mkdir 在许多实际场景中都有广泛的应用，例如：

4.1 自动化脚本

在自动化脚本中，可以使用 os.mkdir 创建临时目录或日志目录。

import os import time # 创建以时间戳命名的日志目录 log_dir = time.strftime("%Y%m%d_%H%M%S") os.mkdir(log_dir) 4.2 文件管理工具

在文件管理工具中，可以使用 os.mkdir 为用户创建个人文件夹或项目文件夹。

import os user_name = "john_doe" user_folder = os.path.join("users", user_name) os.makedirs(user_folder, exist_ok=True) 4.3 数据处理

在数据处理任务中，可以使用 os.mkdir 创建输出目录，用于保存生成的文件。

import os output_dir = "output_data" if not os.path.exists(output_dir): os.mkdir(output_dir)

5. 总结

os.mkdir 是 Python 中一个简单但功能强大的函数，用于在文件系统中创建目录。通过本文的介绍，你应该已经掌握了它的基本用法、注意事项以及相关的扩展知识。在实际开发中，结合 os.path 模块和错误处理机制，可以编写出健壮且跨平台的代码。无论是自动化脚本、文件管理工具还是数据处理任务，os.mkdir 都是一个不可或缺的工具。希望本文能帮助你更好地理解和使用这一函数！