python怎么检查一个文件或文件夹是否存在_python文件与文件夹存在性检查

冰火之心

发布时间：2025-09-15 15:51:01

588人浏览过

来源于php中文网

原创

Python中检查文件或文件夹是否存在，核心是使用os.path.exists()判断路径是否存在，os.path.isfile()检查是否为文件，os.path.isdir()检查是否为目录。三者区别在于：exists()仅判断存在性，isfile()和isdir()则进一步确认类型。实际开发中应优先使用isfile()或isdir()以避免类型错误。常见陷阱包括竞争条件、权限问题、路径大小写敏感、相对路径基准变化及符号链接处理，建议结合try-except处理异常。此外，Python 3.4+推荐使用pathlib模块，其Path对象提供面向对象、跨平台、链式调用等优势，代码更简洁安全。

python怎么检查一个文件或文件夹是否存在_python文件与文件夹存在性检查

Python中检查文件或文件夹是否存在，核心在于利用

os.path

模块提供的一系列函数，如

exists()

、

isfile()

和

isdir()

。它们能快速判断指定路径是否指向一个真实存在的文件、目录，或任何文件系统对象。

解决方案

要检查一个文件或文件夹是否存在，最直接的方法是使用Python的

os.path

模块。这个模块提供了许多与操作系统路径相关的实用函数。

import os

# 假设我们有一个文件路径和一个文件夹路径
file_path = "my_document.txt"
folder_path = "my_project_folder"

# 为了演示，我们先创建它们
# with open(file_path, "w") as f:
#     f.write("Hello, world!")
# os.makedirs(folder_path, exist_ok=True)

# 检查文件是否存在
if os.path.exists(file_path):
    print(f"路径 '{file_path}' 存在。")
    if os.path.isfile(file_path):
        print(f"'{file_path}' 是一个文件。")
    elif os.path.isdir(file_path):
        print(f"'{file_path}' 是一个文件夹。")
else:
    print(f"路径 '{file_path}' 不存在。")

print("-" * 20)

# 检查文件夹是否存在
if os.path.exists(folder_path):
    print(f"路径 '{folder_path}' 存在。")
    if os.path.isfile(folder_path):
        print(f"'{folder_path}' 是一个文件。")
    elif os.path.isdir(folder_path):
        print(f"'{folder_path}' 是一个文件夹。")
else:
    print(f"路径 '{folder_path}' 不存在。")

# 也可以直接检查是否是文件或目录
print("-" * 20)
print(f"'{file_path}' 是文件吗？ {os.path.isfile(file_path)}")
print(f"'{file_path}' 是目录吗？ {os.path.isdir(file_path)}")
print(f"'{folder_path}' 是文件吗？ {os.path.isfile(folder_path)}")
print(f"'{folder_path}' 是目录吗？ {os.path.isdir(folder_path)}")

# 清理演示文件和文件夹 (可选)
# os.remove(file_path)
# os.rmdir(folder_path)

os.path.exists()

、

os.path.isfile()

和

os.path.isdir()

有什么区别？什么时候用哪个？

这三个函数虽然都与“存在”有关，但它们关注的侧重点完全不同，理解它们的差异是避免潜在错误的关键。

```
os.path.exists(path)
```
: 这是最宽泛的检查。它只是简单地判断
```
path
```
所指向的文件系统对象（无论是文件、目录、符号链接还是其他特殊文件）是否存在。如果路径有效且确实有东西在那儿，它就返回
```
True
```
。我个人觉得，这就像是问“这地方有没有东西？”至于是什么东西，它不关心。

立即学习“Python免费学习笔记（深入）”；
- 适用场景: 当你只想知道某个路径是否被占用，或者后续操作对文件类型不敏感时，比如你只想知道一个配置文件是否已经创建，但具体是文件还是目录不重要（虽然这种情况比较少见）。
```
os.path.isfile(path)
```
: 这个函数则更具体，它不仅检查
```
path
```
是否存在，还进一步确认它是否是一个“常规文件”（regular file）。这意味着它会排除目录、符号链接（它会跟随符号链接，检查链接的目标是否是文件）、命名管道等。
- 适用场景: 当你明确需要操作一个文件时，比如读取、写入、解析文件内容。如果你试图用
```
open()
```
  函数去打开一个目录，那肯定会报错。所以，在尝试文件操作前，用
```
isfile()
```
  做个预检，能有效防止类型不匹配的错误。
```
os.path.isdir(path)
```
: 与
```
isfile()
```
类似，
```
isdir()
```
会检查
```
path
```
是否存在，并且确认它是一个目录（directory）。它也会跟随符号链接，检查链接的目标是否是目录。
- 适用场景: 当你需要遍历目录内容、创建子目录或进行其他目录相关操作时。比如，你有一个程序需要将日志写入某个目录，那么在写入之前，先用
```
isdir()
```
  确认目标路径确实是个目录，能让你心里有底。

总结一下我的看法：

exists()

是一个粗略的“有无”判断，而

isfile()

和

isdir()

则是更精确的“是什么”判断。在实际开发中，我通常会优先使用

isfile()

或

isdir()

，因为它们提供了更具体的信息，能帮助我避免在后续操作中遇到类型错误。除非我真的只关心路径是否存在而不关心其类型，否则我会尽量避免单独使用

exists()

。例如，如果我需要读取一个文件，我一定会用

os.path.isfile()

来判断，而不是仅仅用

os.path.exists()

，因为一个目录也可能

exists()

，但你不能

open()

它。

检查文件或文件夹存在性时，可能会遇到哪些常见问题或陷阱？

在检查文件或文件夹存在性时，我们确实会遇到一些让人头疼的问题，这些“坑”往往不是代码逻辑上的错误，而是对文件系统行为理解不深造成的。

竞争条件 (Race Conditions)：这是最经典的陷阱之一。你可能写了这样的代码：
```
if os.path.exists(some_path):
    # 执行一些操作，比如写入文件
    with open(some_path, 'w') as f:
        f.write("content")
```
问题在于，从
```
os.path.exists()
```
返回
```
True
```
到你真正执行文件操作之间，可能存在一个极短的时间窗口。在这个窗口里，另一个进程或用户可能已经删除了这个文件或目录。结果就是，你的代码在
```
exists()
```
判断为真后，尝试操作一个不存在的路径，从而抛出
```
FileNotFoundError
```
。
- 我的经验：坦白说，我踩过这个坑。后来我学到，对于文件操作，尤其是写入或移动，更健壮的做法是“请求原谅比请求许可更好”（Easier to ask for forgiveness than permission，Python之禅）。也就是说，直接尝试操作，然后用
```
try-except
```
  块捕获可能发生的
```
FileNotFoundError
```
  或
```
PermissionError
```
  。
权限问题：一个文件或目录可能确实存在，但当前运行Python脚本的用户可能没有足够的权限去访问它（读取、写入或执行）。
```
os.path.exists()
```
在这种情况下通常仍然会返回
```
True
```
，因为它只检查文件系统元数据，不涉及用户权限。但当你尝试后续操作时，比如
```
open()
```
文件，就会遇到
```
PermissionError
```
。
- 我的经验：这通常在部署到不同环境时出现，比如在Linux服务器上以非root用户运行脚本。解决办法通常是调整文件或目录的权限，或者以有权限的用户运行程序。
路径大小写敏感性：在Windows系统上，文件路径通常是不区分大小写的（
```
C:\MyFile.txt
```
和
```
C:\MyFile.txt
```
是同一个文件）。但在Linux或macOS系统上，路径是区分大小写的。如果你在Windows上开发，路径写成了
```
myFile.txt
```
，部署到Linux上，而实际文件名是
```
myFile.txt
```
，那么
```
os.path.exists()
```
就会返回
```
False
```
。
- 我的经验：养成良好的习惯，在代码中尽量使用与文件系统实际名称完全匹配的路径，或者在处理用户输入路径时进行规范化。
相对路径与绝对路径：当使用相对路径时，它的基准是当前工作目录（Current Working Directory, CWD）。如果你不清楚脚本的CWD是什么，或者CWD在程序运行过程中发生了变化（比如通过
```
os.chdir()
```
），那么相对路径的判断结果就会变得不可预测。

闪念贝壳
闪念贝壳是一款AI 驱动的智能语音笔记，随时随地用语音记录你的每一个想法。

下载
- 我的经验：对于重要的文件或目录，我更倾向于使用绝对路径，或者通过
```
os.path.abspath()
```
  、
```
os.path.join()
```
  等函数来构建可靠的路径。例如，与脚本同目录的文件，我会用
```
os.path.join(os.path.dirname(__file__), 'my_config.ini')
```
  来获取其绝对路径。
符号链接 (Symbolic Links)：
```
os.path.exists()
```
、
```
os.path.isfile()
```
、
```
os.path.isdir()
```
在遇到符号链接时，默认是会“跟随”链接的，即它们会检查链接的目标。如果你需要检查的是符号链接本身是否存在，而不是它指向的目标，你需要使用
```
os.path.islink()
```
。
- 我的经验：这通常在处理复杂的文件系统结构时需要注意，尤其是在备份或同步文件时，区分链接和实际文件非常重要。

这些“坑”都是我在实际开发中遇到过或者看到别人遇到过的，理解它们能帮助我们写出更健壮、更可靠的代码。

除了

os.path

，Python还有其他检查文件系统的方法吗？它们有什么优势？

当然有！Python在处理文件系统路径方面一直在进化。除了经典的

os.path

模块，现代Python（尤其是Python 3.4及更高版本）引入了一个更优雅、更面向对象的模块：pathlib
。坦白说，如果不是为了兼容旧代码或者处理一些非常底层的

os

模块特有的操作，我个人现在更倾向于使用

pathlib

。

pathlib

模块提供了一个

path

对象，它将文件系统路径抽象成了一个对象，你可以像操作字符串一样操作路径，但它提供了更多面向对象的方法。

使用

pathlib

检查文件或文件夹存在性：

from pathlib import Path

# 假设文件和文件夹路径
file_path_pl = Path("my_document_pathlib.txt")
folder_path_pl = Path("my_project_folder_pathlib")

# 为了演示，我们先创建它们
# file_path_pl.write_text("Hello from pathlib!")
# folder_path_pl.mkdir(exist_ok=True)

print("\n--- 使用 pathlib ---")

# 检查文件是否存在
if file_path_pl.exists():
    print(f"路径 '{file_path_pl}' 存在。")
    if file_path_pl.is_file():
        print(f"'{file_path_pl}' 是一个文件。")
    elif file_path_pl.is_dir():
        print(f"'{file_path_pl}' 是一个文件夹。")
else:
    print(f"路径 '{file_path_pl}' 不存在。")

print("-" * 20)

# 检查文件夹是否存在
if folder_path_pl.exists():
    print(f"路径 '{folder_path_pl}' 存在。")
    if folder_path_pl.is_file():
        print(f"'{folder_path_pl}' 是一个文件。")
    elif folder_path_pl.is_dir():
        print(f"'{folder_path_pl}' 是一个文件夹。")
else:
    print(f"路径 '{folder_path_pl}' 不存在。")

# 也可以直接检查是否是文件或目录
print("-" * 20)
print(f"'{file_path_pl}' 是文件吗？ {file_path_pl.is_file()}")
print(f"'{file_path_pl}' 是目录吗？ {file_path_pl.is_dir()}")
print(f"'{folder_path_pl}' 是文件吗？ {folder_path_pl.is_file()}")
print(f"'{folder_path_pl}' 是目录吗？ {folder_path_pl.is_dir()}")

# 清理演示文件和文件夹 (可选)
# file_path_pl.unlink(missing_ok=True) # 删除文件
# folder_path_pl.rmdir() # 删除空目录

pathlib

的优势：

面向对象，更直观易读：
```
pathlib
```
将路径视为对象，而不是简单的字符串。这意味着你可以直接在
```
path
```
对象上调用方法，比如
```
path.exists()
```
、
```
path.is_file()
```
、
```
path.parent
```
、
```
path.name
```
等，代码的可读性和表达力大大增强。
路径拼接更安全、更简洁：使用
```
os.path.join()
```
拼接路径时，你需要小心处理斜杠和反斜杠，而且参数顺序也需要注意。
```
pathlib
```
通过
```
/
```
运算符重载，让路径拼接变得像字符串拼接一样自然，而且它会自动处理不同操作系统的路径分隔符。
```
# os.path 方式
import os
p1 = os.path.join('my_dir', 'sub_dir', 'file.txt')

# pathlib 方式
from pathlib import Path
p2 = Path('my_dir') / 'sub_dir' / 'file.txt'
```
这在我看来，简直是代码洁癖者的福音。

链式调用，操作流畅：

pathlib

的方法通常返回

path

对象，这使得你可以进行链式调用，写出非常紧凑且逻辑清晰的代码。

# 检查一个目录下的某个文件是否存在
if (Path('my_project') / 'config' / 'settings.ini').is_file():
    print("配置文件存在。")

提供更多高级功能：除了存在性检查，
```
pathlib
```
还提供了创建目录（
```
mkdir()
```
）、删除文件（
```
unlink()
```
）、删除目录（
```
rmdir()
```
）、文件移动（
```
rename()
```
、
```
replace()
```
）、读取/写入文件内容（
```
read_text()
```
、
```
write_text()
```
）等一系列强大的功能，使得文件系统操作更加集成和统一。
跨平台一致性：
```
pathlib
```
在底层会处理不同操作系统（Windows、Linux、macOS）路径表示的差异，提供了一致的API，减少了跨平台开发时的心智负担。