os.mkdir创建单层目录 - Python文件夹创建操作教程

一、函数概述

os.mkdir() 函数用于创建一个新目录。它只能创建单层目录，如果父目录不存在则会报错。如需递归创建多层目录，请使用 os.makedirs()。

二、语法与参数

语法

os.mkdir(path, mode=0o777, *, dir_fd=None)

参数说明

返回值

无返回值。如果目录已存在或父目录不存在，将抛出相应异常。

三、基本用法示例

创建单个目录

import os

new_dir = 'test_folder'
if not os.path.exists(new_dir):
    os.mkdir(new_dir)
    print(f"目录 '{new_dir}' 创建成功")
else:
    print(f"目录 '{new_dir}' 已存在")

输出：

目录 'test_folder' 创建成功

四、使用绝对路径创建目录

import os

new_dir = os.path.join(os.getcwd(), 'logs')
try:
    os.mkdir(new_dir)
    print(f"目录创建成功: {new_dir}")
except FileExistsError:
    print(f"目录已存在: {new_dir}")

输出：

目录创建成功: C:\Users\example\project\logs

五、创建目录时的常见错误

import os

# 错误1：父目录不存在
try:
    os.mkdir('parent/child/grandchild')
except FileNotFoundError as e:
    print(f"错误: 父目录不存在 - {e}")

# 错误2：目录已存在
try:
    os.mkdir('existing_dir')
except FileExistsError as e:
    print(f"错误: 目录已存在 - {e}")

输出：

错误: 父目录不存在 - [Errno 2] No such file or directory: 'parent/child/grandchild'

常见异常类型：

• FileNotFoundError：父目录不存在

• FileExistsError：目标目录已存在

• PermissionError：没有创建目录的权限

六、实际应用场景

• 场景1：在项目初始化时创建必要的目录结构（如logs、data、output等）

• 场景2：在文件下载程序中，按日期创建目录存储下载文件

• 场景3：在数据处理脚本中，为每个处理批次创建独立的输出目录

七、注意事项

注意：os.mkdir()只能创建单层目录，父目录必须存在。

注意：如果目录已存在，会抛出FileExistsError。

注意：mode参数在Windows上基本无效，仅在Unix系统上设置目录权限。

八、创建目录方法对比

九、小结

• os.mkdir()用于创建单层目录，父目录必须存在

• 创建前应检查目录是否已存在，避免FileExistsError

• 如需创建多层嵌套目录，使用os.makedirs()更方便

十、练习题