在 Python 中,os.makedirs() 函数用于递归地创建目录。也就是说,它不仅会创建指定的目录,还会创建任何必要的父目录。这个函数在处理需要创建多级目录结构时非常有用。
1、语法
os.makedirs(name, mode=0o777, exist_ok=False)
1.1、参数
- name:要创建的目标目录路径,可以是绝对路径或相对路径。
- mode(可选):设置目录的权限模式,默认为 0o777(八进制表示),即读、写、执行权限对所有用户开放。
- exist_ok(可选):如果为 True,当目标目录已经存在时不会引发异常;如果为 False(默认值),当目标目录已经存在时会引发 FileExistsError 异常。
1.2、返回值
- 该函数没有返回值。
1.3、示例
1.3.1、基本用法
import os# 创建单级目录os.makedirs('test_dir')# 创建多级目录os.makedirs('parent_dir/child_dir/grandchild_dir')
1.3.2、使用 mode 参数
import os# 创建目录并设置权限为 0o755os.makedirs('secure_dir', mode=0o755)
1.3.3、使用 exist_ok 参数
import os# 创建目录,如果目录已存在则不会引发异常os.makedirs('existing_dir', exist_ok=True)
1.3.4、错误处理
如果目标目录已经存在且 exist_ok 参数为 False,会引发 FileExistsError 异常:
import ostry:os.makedirs('existing_dir')except FileExistsError:print("Directory already exists")
2、实际应用
os.makedirs() 函数在需要确保目录结构存在时非常有用,例如在文件写入操作之前:
import osdef save_file(file_path, content):# 提取目录路径dir_path = os.path.dirname(file_path)# 创建目录(如果不存在)os.makedirs(dir_path, exist_ok=True)# 写入文件with open(file_path, 'w') as file:file.write(content)# 使用示例save_file('data/output/file.txt', 'Hello, world!')
通过使用 os.makedirs() 函数,可以方便地创建所需的目录结构,从而避免手动检查和创建目录的繁琐过程,提高代码的简洁性和可维护性。