python 中如何新建文件夹

在Python中新建文件夹的方法包括使用os模块、pathlib模块、以及第三方库shutil等，这些方法各有优缺点，适合不同的场景。其中，os模块是最常见的方式，pathlib模块在Python 3.4及更高版本中提供了更现代化的接口，而shutil模块则适用于更复杂的文件操作任务。下面将详细介绍这些方法，并提供实际代码示例。

一、使用os模块新建文件夹

1、os.mkdir()

os.mkdir()是Python中最基本的文件夹创建方法之一。它只能创建单层文件夹，如果文件夹已经存在，会抛出FileExistsError异常。

import os

指定文件夹路径
folder_path = 'example_folder'
创建文件夹
try:
    os.mkdir(folder_path)
    print(f"文件夹 '{folder_path}' 创建成功")
except FileExistsError:
    print(f"文件夹 '{folder_path}' 已经存在")

2、os.makedirs()

os.makedirs()可以递归地创建多层文件夹，适合需要一次性创建多层嵌套文件夹的场景。

import os

指定多层文件夹路径
multi_layer_folder = 'example_folder/subfolder/subsubfolder'
创建多层文件夹
try:
    os.makedirs(multi_layer_folder)
    print(f"多层文件夹 '{multi_layer_folder}' 创建成功")
except FileExistsError:
    print(f"多层文件夹 '{multi_layer_folder}' 已经存在")

二、使用pathlib模块新建文件夹

pathlib模块提供了面向对象的文件和文件夹操作接口，是Python 3.4及更高版本中推荐使用的方式。

1、Path.mkdir()

Path.mkdir()类似于os.mkdir()，但提供了更多的选项和更好的错误处理机制。

from pathlib import Path

指定文件夹路径
folder_path = Path('example_folder')
创建文件夹
try:
    folder_path.mkdir()
    print(f"文件夹 '{folder_path}' 创建成功")
except FileExistsError:
    print(f"文件夹 '{folder_path}' 已经存在")

2、Path.mkdir(parents=True)

使用parents=True参数，可以递归地创建多层文件夹，类似于os.makedirs()。

from pathlib import Path

指定多层文件夹路径
multi_layer_folder = Path('example_folder/subfolder/subsubfolder')
创建多层文件夹
try:
    multi_layer_folder.mkdir(parents=True)
    print(f"多层文件夹 '{multi_layer_folder}' 创建成功")
except FileExistsError:
    print(f"多层文件夹 '{multi_layer_folder}' 已经存在")

三、使用第三方库shutil新建文件夹

shutil模块主要用于高级文件操作，如复制文件和文件夹，但它也可以创建文件夹。

1、shutil.copytree()

虽然shutil.copytree()主要用于复制文件夹，但在复制过程中也会创建目标文件夹。如果目标文件夹已经存在，会抛出FileExistsError异常。

import shutil

指定源文件夹和目标文件夹路径
source_folder = 'source_folder'
target_folder = 'target_folder'
创建源文件夹以便复制（如果不存在）
os.makedirs(source_folder, exist_ok=True)
复制文件夹
try:
    shutil.copytree(source_folder, target_folder)
    print(f"文件夹 '{target_folder}' 创建成功")
except FileExistsError:
    print(f"文件夹 '{target_folder}' 已经存在")

四、文件夹权限设置

在创建文件夹时，可以设置文件夹的权限。默认情况下，文件夹权限由系统决定，但你可以通过传递mode参数来设置特定的权限。

import os

指定文件夹路径和权限
folder_path = 'example_folder'
permissions = 0o755  # rwxr-xr-x
创建文件夹并设置权限
try:
    os.mkdir(folder_path, mode=permissions)
    print(f"文件夹 '{folder_path}' 创建成功，权限设置为 {oct(permissions)}")
except FileExistsError:
    print(f"文件夹 '{folder_path}' 已经存在")

五、文件夹存在性检查

在创建文件夹之前，通常需要检查文件夹是否已经存在，以避免抛出异常。可以使用os.path.exists()或者Path.exists()来进行检查。

import os

指定文件夹路径
folder_path = 'example_folder'
检查文件夹是否存在
if not os.path.exists(folder_path):
    os.mkdir(folder_path)
    print(f"文件夹 '{folder_path}' 创建成功")
else:
    print(f"文件夹 '{folder_path}' 已经存在")

六、错误处理与异常捕获

在实际使用中，处理各种可能的异常是非常重要的。除了FileExistsError，还可能会遇到权限错误（PermissionError）和文件系统错误（OSError）。

import os

指定文件夹路径
folder_path = 'example_folder'
创建文件夹并处理各种异常
try:
    os.mkdir(folder_path)
    print(f"文件夹 '{folder_path}' 创建成功")
except FileExistsError:
    print(f"文件夹 '{folder_path}' 已经存在")
except PermissionError:
    print(f"没有权限创建文件夹 '{folder_path}'")
except OSError as e:
    print(f"创建文件夹 '{folder_path}' 时发生错误: {e}")

七、实际应用场景

1、项目结构初始化

在开发项目时，经常需要初始化项目结构。这时可以使用递归创建多层文件夹的方法。

import os

指定项目结构
project_structure = [
    'project/src',
    'project/tests',
    'project/docs',
    'project/data/raw',
    'project/data/processed'
]
创建项目结构
for folder in project_structure:
    os.makedirs(folder, exist_ok=True)
    print(f"文件夹 '{folder}' 创建成功")

2、日志文件夹管理

在记录日志时，需要确保日志文件夹存在。这时可以使用文件夹存在性检查方法。

import os

from datetime import datetime
指定日志文件夹路径
log_folder = 'logs'
current_date = datetime.now().strftime('%Y-%m-%d')
log_folder_path = os.path.join(log_folder, current_date)
检查并创建日志文件夹
if not os.path.exists(log_folder_path):
    os.makedirs(log_folder_path)
    print(f"日志文件夹 '{log_folder_path}' 创建成功")
else:
    print(f"日志文件夹 '{log_folder_path}' 已经存在")

八、总结

Python提供了多种创建文件夹的方法，包括os模块、pathlib模块以及第三方库shutil。 在实际应用中，可以根据具体需求选择合适的方法。对于简单的文件夹创建任务，os.mkdir()和os.makedirs()是最常见的选择；对于更现代化的接口和面向对象的操作，推荐使用pathlib模块；而对于更复杂的文件操作任务，可以考虑使用shutil模块。

无论使用哪种方法，处理文件夹存在性检查和异常捕获都是非常重要的，以确保程序的健壮性和稳定性。通过合理使用这些方法，可以轻松管理项目结构、日志文件夹等，提高开发效率和代码质量。

相关问答FAQs：

1. 如何在Python中创建一个新的文件夹？

要在Python中创建一个新的文件夹，您可以使用os模块中的mkdir函数。您可以按照以下步骤执行：

import os

# 指定新文件夹的路径
folder_path = 'path/to/new_folder'

# 使用mkdir函数创建新文件夹
os.mkdir(folder_path)

2. 如何在Python中创建一个带有子文件夹的文件夹？

要在Python中创建一个带有子文件夹的文件夹，您可以使用os模块中的makedirs函数。您可以按照以下步骤执行：

import os

# 指定新文件夹的路径
folder_path = 'path/to/new_folder'

# 使用makedirs函数创建新文件夹及其子文件夹
os.makedirs(folder_path)

3. 如何在Python中检查文件夹是否存在？

要在Python中检查文件夹是否存在，您可以使用os模块中的path函数。您可以按照以下步骤执行：

import os

# 指定文件夹的路径
folder_path = 'path/to/folder'

# 使用exists函数检查文件夹是否存在
if os.path.exists(folder_path):
    print("文件夹已存在！")
else:
    print("文件夹不存在！")