Python怎么创建文件夹_os模块与Pathlib库文件夹创建-Python教程-PHP中文网

最直接有效的方式是使用os.makedirs()或pathlib.Path.mkdir()，两者均支持创建多级目录并处理已存在情况。推荐使用pathlib，因其面向对象、跨平台且语法简洁，结合parents=True和exist_ok=True可安全实现幂等创建。

python怎么创建文件夹_os模块与pathlib库文件夹创建

在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
```
登录后复制
方法，如果父目录不存在，也一并创建它们。我个人觉得这种方式更具表现力，因为它清楚地说明了你的意图。

文心大模型
百度飞桨-文心大模型 ERNIE 3.0 文本理解与创作

56

查看详情

处理文件夹已存在的情况：

这是确保操作“安全”的关键一环。我们不希望脚本因为文件夹已经存在而崩溃。

```
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的文件操作函数会尊重底层文件系统的行为，但作为开发者，最好始终使用一致的命名约定，避免依赖大小写敏感性，以减少潜在的跨平台问题。