最直接有效的方式是使用os.makedirs()或pathlib.Path.mkdir()，两者均支持创建多级目录并处理已存在情况。推荐使用pathlib，因其面向对象、跨平台且语法简洁，结合parents=True和exist_ok=True可安全实现幂等创建。
在Python中创建文件夹，最直接有效的方式是利用其内置的
os模块或现代的
pathlib库。这两者都能让你轻松地创建单层或多层目录，并提供了处理文件夹已存在情况的机制，避免不必要的错误。选择哪一个，往往取决于你的项目需求和个人偏好，但通常来说，
pathlib以其面向对象的简洁性，正逐渐成为更受欢迎的选择。
解决方案
Python提供了两种主要的、且都非常可靠的方法来创建文件夹：
os模块和
pathlib库。我将分别介绍它们，并给出实际的代码示例。
使用 os
模块创建文件夹
os模块是Python标准库中用于与操作系统交互的接口。它提供了大量函数来处理文件和目录。
立即学习“Python免费学习笔记（深入）”；
-
创建单个目录 (
os.mkdir
): 如果你只需要创建一个不存在的单层目录，os.mkdir()
是你的首选。import os folder_name = "my_new_folder_os" try: os.mkdir(folder_name) print(f"文件夹 '{folder_name}' 创建成功。") except FileExistsError: print(f"文件夹 '{folder_name}' 已经存在。") except OSError as e: print(f"创建文件夹时发生错误: {e}")这里需要注意的是，如果
my_new_folder_os
已经存在，os.mkdir()
会抛出FileExistsError
。所以，通常我们需要用try-except
块来捕获这个异常，或者在创建前先检查它是否存在（尽管这可能引入竞态条件）。 -
创建多级目录 (
os.makedirs
): 当需要创建多层嵌套的目录结构时，os.makedirs()
就显得非常方便了。它会递归地创建所有不存在的父级目录。import os nested_folder_path = "parent_folder_os/child_folder_os/grandchild_folder_os" try: os.makedirs(nested_folder_path) print(f"多级文件夹 '{nested_folder_path}' 创建成功。") except FileExistsError: print(f"多级文件夹 '{nested_folder_path}' 已经存在。") except OSError as e: print(f"创建多级文件夹时发生错误: {e}") # 更安全的做法，避免FileExistsError safe_nested_path = "another_parent_os/another_child_os" os.makedirs(safe_nested_path, exist_ok=True) print(f"使用 exist_ok=True 创建或确保文件夹 '{safe_nested_path}' 存在。")os.makedirs()
的一个强大之处在于它有一个exist_ok=True
参数。设置这个参数后，如果目标目录已经存在，它就不会抛出FileExistsError
，而是默默地完成操作，这在很多场景下非常实用，可以避免我们手动检查目录是否存在。
使用 pathlib
库创建文件夹
pathlib是Python 3.4+引入的一个库，它提供了一种面向对象的方式来处理文件系统路径。我个人非常喜欢它的API设计，它让路径操作变得更加直观和链式化。
-
创建单个目录 (
Path.mkdir
):pathlib
中的Path
对象代表文件系统路径。你可以通过它来调用mkdir()
方法。from pathlib import Path folder_name_pl = Path("my_new_folder_pathlib") try: folder_name_pl.mkdir() print(f"文件夹 '{folder_name_pl}' 创建成功。") except FileExistsError: print(f"文件夹 '{folder_name_pl}' 已经存在。") except OSError as e: print(f"创建文件夹时发生错误: {e}")和
os.mkdir()
一样，Path.mkdir()
在目录已存在时会抛出FileExistsError
。 -
创建多级目录 (
Path.mkdir
与parents
和exist_ok
):pathlib
的mkdir()
方法同样支持创建多级目录和处理已存在的目录，通过parents=True
和exist_ok=True
参数。from pathlib import Path nested_folder_path_pl = Path("parent_folder_pl/child_folder_pl/grandchild_folder_pl") try: nested_folder_path_pl.mkdir(parents=True) print(f"多级文件夹 '{nested_folder_path_pl}' 创建成功。") except FileExistsError: print(f"多级文件夹 '{nested_folder_path_pl}' 已经存在。") except OSError as e: print(f"创建多级文件夹时发生错误: {e}") # 更安全的做法，使用 parents=True 和 exist_ok=True safe_nested_path_pl = Path("another_parent_pl/another_child_pl") safe_nested_path_pl.mkdir(parents=True, exist_ok=True) print(f"使用 parents=True 和 exist_ok=True 创建或确保文件夹 '{safe_nested_path_pl}' 存在。")这里的
parents=True
等同于os.makedirs()
的功能，它会创建路径中所有缺失的父目录。而exist_ok=True
则确保如果目录已经存在，不会抛出错误。这两个参数结合使用，让pathlib
的目录创建操作变得异常强大和优雅。
os
模块与 pathlib
库在创建文件夹时有哪些核心差异和最佳实践？
在我看来，
os模块和
pathlib库在Python中处理文件系统路径时，代表了两种不同的哲学。
os模块更偏向于传统的、过程式的编程风格，它的函数直接操作字符串路径，你需要自己拼接路径、处理分隔符，虽然功能强大，但在处理复杂路径时可能会显得有些笨重。而
pathlib则采用了面向对象的设计，将路径抽象为一个
Path对象，这个对象拥有各种方法来执行文件系统操作，比如创建文件夹、检查文件是否存在、拼接路径等等。
核心差异：
-
编程范式：
os
是函数式的，接受字符串作为路径参数；pathlib
是面向对象的，路径是Path
对象，操作是对象的方法。 -
路径表示：
os
模块的函数通常接受字符串路径，这意味着你需要手动处理路径分隔符（尽管os.path.join
可以帮助你）。pathlib
则将路径封装为Path
对象，它会自动处理不同操作系统下的路径分隔符，使得代码更具跨平台性。 -
链式操作：
pathlib
的Path
对象支持链式调用，例如Path(".").joinpath("sub", "folder").mkdir()，这种风格让代码更加简洁易读。os
模块则需要多次函数调用。 -
易读性与维护性： 我个人觉得
pathlib
的代码通常更具可读性，因为它将文件系统操作与路径本身紧密结合，语义更清晰。当路径操作变得复杂时，pathlib
的优势尤为明显。
最佳实践：
-
对于新项目或Python 3.4+环境： 强烈推荐使用
pathlib
。它的API设计更现代，更符合Pythonic风格，能让你的代码更健壮、更易读。 -
对于需要与旧代码库兼容或简单快速脚本：
os
模块仍然是完全可用的。尤其是一些非常底层的、直接与操作系统交互的功能，os
模块可能仍然是唯一的选择。 -
处理跨平台路径：
pathlib
在这方面表现出色。它抽象了操作系统差异，你无需担心Windows的\
和Unix/Linux的/
。 -
创建多级目录和处理已存在目录： 两者都提供了
exist_ok=True
（os.makedirs
和Path.mkdir
）和parents=True
（Path.mkdir
）这样的参数，这对于编写幂等脚本（即无论运行多少次都能得到相同结果）至关重要。我总是建议使用这些参数，以避免不必要的错误处理逻辑。
如何在Python中安全地创建多级嵌套文件夹，并处理文件夹已存在的情况？
安全地创建多级嵌套文件夹，核心在于两点：一是确保所有必要的父级目录都被创建，二是优雅地处理目标文件夹已经存在的情况。如果只是简单地调用
mkdir而不考虑这些，很容易遇到
FileNotFoundError（父目录不存在）或
FileExistsError（目标目录已存在）。
确保创建所有父级目录：
无论是
os模块还是
pathlib库，都提供了专门的机制来处理这个问题。
os.makedirs(path)
: 这个函数就是为此而生的。当你提供一个像"data/raw/2023/q1"
这样的路径时，如果data
、data/raw
、data/raw/2023
这些目录都不存在，os.makedirs()
会逐级创建它们，直到q1
目录也被创建。这是它与os.mkdir()
最主要的区别，后者只能创建路径中最后一部分目录，且要求其所有父目录都已存在。Path(path).mkdir(parents=True)
:pathlib
库通过Path
对象的mkdir
方法，并传入parents=True
参数来实现同样的功能。这告诉mkdir
方法，如果父目录不存在，也一并创建它们。我个人觉得这种方式更具表现力，因为它清楚地说明了你的意图。
ECTouch移动商城系统下载ECTouch是上海商创网络科技有限公司推出的一套基于 PHP 和 MySQL 数据库构建的开源且易于使用的移动商城网店系统！应用于各种服务器平台的高效、快速和易于管理的网店解决方案，采用稳定的MVC框架开发，完美对接ecshop系统与模板堂众多模板，为中小企业提供最佳的移动电商解决方案。ECTouch程序源代码完全无加密。安装时只需将已集成的文件夹放进指定位置，通过浏览器访问一键安装，无需对已有
处理文件夹已存在的情况：
这是确保操作“安全”的关键一环。我们不希望脚本因为文件夹已经存在而崩溃。
os.makedirs(path, exist_ok=True)
: 在os.makedirs()
中，添加exist_ok=True
参数是一个非常优雅的解决方案。如果目标目录（以及所有父目录）都已经存在，Python会忽略这个操作，不会抛出任何错误。这使得你的代码具有“幂等性”，无论运行多少次，结果都是一样的，非常适合自动化脚本。Path(path).mkdir(parents=True, exist_ok=True)
:pathlib
库也提供了exist_ok=True
参数，与parents=True
结合使用时，它会首先确保所有父目录存在，然后尝试创建目标目录。如果目标目录已存在，也不会引发错误。
示例代码（强调安全性和幂等性）：
import os
from pathlib import Path
# 使用 os 模块
safe_folder_os = "project_data/logs/daily_report"
print(f"尝试使用 os.makedirs 安全创建 '{safe_folder_os}'...")
os.makedirs(safe_folder_os, exist_ok=True)
print(f"'{safe_folder_os}' 目录已确保存在。")
# 再次运行，验证幂等性
print(f"再次尝试使用 os.makedirs 安全创建 '{safe_folder_os}'...")
os.makedirs(safe_folder_os, exist_ok=True)
print(f"'{safe_folder_os}' 目录再次确保存在，没有错误。")
print("-" * 30)
# 使用 pathlib 库
safe_folder_pl = Path("user_profiles/admin/settings")
print(f"尝试使用 pathlib.mkdir 安全创建 '{safe_folder_pl}'...")
safe_folder_pl.mkdir(parents=True, exist_ok=True)
print(f"'{safe_folder_pl}' 目录已确保存在。")
# 再次运行，验证幂等性
print(f"再次尝试使用 pathlib.mkdir 安全创建 '{safe_folder_pl}'...")
safe_folder_pl.mkdir(parents=True, exist_ok=True)
print(f"'{safe_folder_pl}' 目录再次确保存在，没有错误。")通过以上方法，你的Python脚本在创建文件夹时将更加健壮和可靠，无论面对何种初始的文件系统状态，都能按预期执行。
Python创建文件夹时常见的权限问题与跨平台兼容性如何解决？
在Python中创建文件夹，虽然代码本身通常是直观的，但实际运行中可能会遇到一些“坑”，其中最常见的就是权限问题，其次是隐晦的跨平台兼容性考量。
权限问题：
这几乎是所有文件系统操作的噩梦。当你尝试在一个没有写入权限的目录下创建文件夹时，Python会抛出
PermissionError。这通常发生在以下几种情况：
-
操作系统限制： 比如在Linux/macOS上，你可能尝试在
/
根目录、/usr
、/bin
等系统级目录中创建文件或文件夹，而当前用户没有root权限。在Windows上，系统盘的某些目录（如C:\Program Files
）也可能受保护。 - 文件系统权限设置： 即使不是系统目录，某个父目录的权限设置也可能阻止你创建子目录。例如，一个目录被设置为只读，或者只允许特定用户组写入。
- 网络共享驱动器： 如果你正在操作网络共享驱动器，权限问题会变得更复杂，可能涉及到网络用户、共享权限和本地权限的叠加。
如何解决权限问题：
运行脚本时使用足够权限： 最直接的方法是确保运行Python脚本的用户拥有目标路径的写入权限。在Linux/macOS上，这意味着可能需要使用
sudo python your_script.py
（但请谨慎，因为这会赋予脚本很大的权限）。在Windows上，你可以尝试以管理员身份运行命令提示符或PowerShell，然后执行脚本。-
选择合适的创建路径： 避免在系统关键目录或已知受保护的区域创建文件夹。通常，用户数据应该存放在用户的主目录（
~/
或C:\Users\YourUser
）、临时目录（tempfile.gettempdir()
）或者应用程序自己的数据目录中。- 获取用户主目录：
Path.home()
(pathlib) 或os.path.expanduser('~')(os)
- 获取用户主目录：
-
错误处理： 无论你多么小心，权限问题总有可能发生。因此，在创建文件夹的代码周围加上
try-except PermissionError
块是最佳实践。这样，当权限不足时，你的程序不会崩溃，而是可以优雅地报告错误或采取备用方案。import os from pathlib import Path try_path = "/root/my_app_data" # 假设这是一个普通用户没有权限的路径 try: Path(try_path).mkdir(parents=True, exist_ok=True) print(f"文件夹 '{try_path}' 创建成功。") except PermissionError: print(f"错误：没有权限在 '{try_path}' 创建文件夹。请检查权限或尝试其他路径。") except Exception as e: # 捕获其他可能的错误 print(f"创建文件夹时发生未知错误: {e}")
跨平台兼容性：
Python在设计时就考虑到了跨平台兼容性，
os模块和
pathlib库在这方面做得非常好。
-
路径分隔符： 这是最常见的跨平台差异。Windows使用反斜杠
\
作为路径分隔符（如C:\Users\Admin\Documents
），而Unix/Linux/macOS使用正斜杠/
（如/home/user/documents
）。-
os
模块：os.path.join()
函数是解决这个问题的关键。它会根据当前操作系统自动选择正确的路径分隔符来拼接路径。避免手动拼接字符串。 -
pathlib
库：Path
对象会自动处理路径分隔符。你可以始终使用正斜杠来定义路径，pathlib
在内部会将其转换为当前操作系统适用的格式。这使得pathlib
在编写跨平台代码时尤其方便。
import os from pathlib import Path # os 模块的跨平台路径拼接 folder_name = "reports" sub_folder = "2023_q4" file_name = "summary.txt" full_path_os = os.path.join(folder_name, sub_folder, file_name) print(f"os.path.join 拼接的路径: {full_path_os}") # 在Windows上会是'reports\2023_q4\summary.txt'，在Linux上是'reports/2023_q4/summary.txt' # pathlib 库的跨平台路径拼接 full_path_pl = Path("reports") / "2023_q4" / "summary.txt" print(f"pathlib 拼接的路径: {full_path_pl}") # 同样会自动适应操作系统 -
文件系统大小写敏感性： Unix/Linux文件系统通常是大小写敏感的（
File.txt
和File.txt
是两个不同的文件），而Windows文件系统通常是大小写不敏感的。虽然Python的文件操作函数会尊重底层文件系统的行为，但作为开发者，最好始终使用一致的命名约定，避免依赖大小写敏感性，以减少潜在的跨平台问题。
总的来说，处理权限问题主要依靠良好的错误处理和选择合适的存储位置。而跨平台兼容性，Python的
os.path.join和
pathlib库已经为你做了大部分工作，你只需要遵循它们的推荐用法即可。
