用Python新建一个文件夹，可以使用os模块、pathlib模块、或者shutil模块，这些方法简单高效、易于维护、兼容性好。其中，最常用的方法是使用os模块。接下来，我们将详细介绍这几种方法，并给出具体的代码示例和注意事项。
一、使用os模块新建文件夹
os模块是Python标准库中的一个模块，提供了非常多的与操作系统交互的接口。使用os模块新建文件夹非常简单，只需要调用os.mkdir()函数。
示例代码
import os
def create_folder(folder_name):
try:
os.mkdir(folder_name)
print(f"Folder '{folder_name}' created successfully.")
except FileExistsError:
print(f"Folder '{folder_name}' already exists.")
except Exception as e:
print(f"An error occurred: {e}")
create_folder("new_folder")
详细描述
os.mkdir()函数用于创建一个新的目录。它接受一个参数，即要创建的目录的名称或路径。如果目录已经存在，会抛出FileExistsError异常。因此，在实际应用中，最好先检查目录是否存在，或者捕获该异常。
二、使用pathlib模块新建文件夹
pathlib模块是Python 3.4引入的一个模块，提供了一些面向对象的文件系统路径操作方法。它使得路径操作更加直观和易读。
示例代码
from pathlib import Path
def create_folder(folder_name):
path = Path(folder_name)
try:
path.mkdir()
print(f"Folder '{folder_name}' created successfully.")
except FileExistsError:
print(f"Folder '{folder_name}' already exists.")
except Exception as e:
print(f"An error occurred: {e}")
create_folder("new_folder")
详细描述
Path.mkdir()方法用于创建一个新的目录。与os.mkdir()类似，它也会在目录已经存在时抛出FileExistsError异常。pathlib模块的优势在于它的面向对象的设计，使得代码更加简洁和易读。
三、使用shutil模块新建文件夹
shutil模块主要用于高级的文件操作，如复制、移动、删除文件等。虽然它不是专门用于创建目录的，但在某些情况下，shutil模块也可以用来创建目录。
示例代码
import shutil
def create_folder(folder_name):
try:
shutil.os.mkdir(folder_name)
print(f"Folder '{folder_name}' created successfully.")
except FileExistsError:
print(f"Folder '{folder_name}' already exists.")
except Exception as e:
print(f"An error occurred: {e}")
create_folder("new_folder")
详细描述
虽然shutil模块主要用于高级文件操作，但它实际上是封装了os模块的一些功能。所以使用shutil模块创建目录实际上是调用了os模块的os.mkdir()函数。
四、检查和创建多级目录
在实际应用中，有时候我们需要创建多级目录（即嵌套目录）。这时，单纯的os.mkdir()或Path.mkdir()无法满足需求，因为它们只能创建一级目录。要创建多级目录，可以使用os.makedirs()或Path.mkdir(parents=True)。
使用os.makedirs()
import os
def create_folders(folder_path):
try:
os.makedirs(folder_path)
print(f"Folders '{folder_path}' created successfully.")
except FileExistsError:
print(f"Folders '{folder_path}' already exist.")
except Exception as e:
print(f"An error occurred: {e}")
create_folders("parent_folder/child_folder")
使用Path.mkdir(parents=True)
from pathlib import Path
def create_folders(folder_path):
path = Path(folder_path)
try:
path.mkdir(parents=True)
print(f"Folders '{folder_path}' created successfully.")
except FileExistsError:
print(f"Folders '{folder_path}' already exist.")
except Exception as e:
print(f"An error occurred: {e}")
create_folders("parent_folder/child_folder")
详细描述
os.makedirs()和Path.mkdir(parents=True)都可以用来创建多级目录。如果目录已经存在，会抛出FileExistsError异常。与os.mkdir()不同的是，这两个方法可以递归地创建不存在的父目录。
五、处理文件路径的特殊情况
在处理文件路径时，还需要考虑一些特殊情况，如路径分隔符的差异、相对路径和绝对路径的转换等。Python提供了os.path模块和pathlib模块来解决这些问题。
示例代码：处理路径分隔符
import os
def create_folder(folder_path):
normalized_path = os.path.normpath(folder_path)
try:
os.makedirs(normalized_path)
print(f"Folder '{normalized_path}' created successfully.")
except FileExistsError:
print(f"Folder '{normalized_path}' already exists.")
except Exception as e:
print(f"An error occurred: {e}")
create_folder("parent_folder\\child_folder")
示例代码：相对路径和绝对路径的转换
from pathlib import Path
def create_folder(folder_path):
path = Path(folder_path).resolve()
try:
path.mkdir(parents=True)
print(f"Folder '{path}' created successfully.")
except FileExistsError:
print(f"Folder '{path}' already exists.")
except Exception as e:
print(f"An error occurred: {e}")
create_folder("parent_folder/child_folder")
详细描述
os.path.normpath()可以标准化路径分隔符，使得代码在不同操作系统上具有更好的兼容性。Path.resolve()可以将相对路径转换为绝对路径，避免路径混淆。
六、异常处理和日志记录
在实际应用中，良好的异常处理和日志记录是非常重要的。通过捕获异常和记录日志，可以更好地调试和维护代码。
示例代码：异常处理和日志记录
import os
import logging
def create_folder(folder_path):
logging.basicConfig(filename='folder_creation.log', level=logging.INFO)
try:
os.makedirs(folder_path)
logging.info(f"Folder '{folder_path}' created successfully.")
except FileExistsError:
logging.warning(f"Folder '{folder_path}' already exists.")
except Exception as e:
logging.error(f"An error occurred: {e}")
create_folder("parent_folder/child_folder")
详细描述
通过使用logging模块，可以将日志信息记录到文件中。这样，在代码运行过程中发生异常时，可以通过查看日志文件来了解详细的异常信息，便于调试和维护。
七、总结
用Python新建一个文件夹的方法有很多，其中最常用的是使用os模块和pathlib模块。os模块简单易用、兼容性好，而pathlib模块提供了面向对象的接口，使得代码更加简洁和易读。此外，shutil模块也可以用来创建目录，但它主要用于高级文件操作。在处理多级目录和路径分隔符时，可以使用os.makedirs()和Path.mkdir(parents=True)。良好的异常处理和日志记录可以提高代码的可维护性和可调试性。希望这些方法和示例代码对你有所帮助。
相关问答FAQs：
如何使用Python创建多个文件夹？
在Python中，可以通过循环结合os模块来创建多个文件夹。可以使用os.makedirs()函数，在指定的路径下创建多个文件夹，包括任何必要的父文件夹。例如：
import os
folders = ["folder1", "folder2", "folder3"]
for folder in folders:
os.makedirs(folder, exist_ok=True)
上述代码会在当前目录下创建三个文件夹，如果文件夹已存在，则不会报错。
在创建文件夹时如何处理异常情况？
在创建文件夹时，可能会遇到权限不足或路径无效的情况。使用try-except语句可以捕获异常并进行处理。例如：
import os
try:
os.makedirs("new_folder")
except OSError as e:
print(f"创建文件夹时出错: {e}")
通过这种方式，可以确保程序在遇到错误时不会崩溃，并能够输出具体的错误信息。
如何使用Python创建带有特定权限的文件夹？
使用os模块创建文件夹后，可以通过os.chmod()函数设置特定的权限。例如，要创建一个文件夹并将其权限设置为只读：
import os
import stat
folder_name = "protected_folder"
os.makedirs(folder_name, exist_ok=True)
os.chmod(folder_name, stat.S_IREAD) # 只读权限
这种方法确保创建的文件夹在操作系统层面上具有所需的访问权限设置。
