Python路径不是目录错误NotADirectoryError处理教程

答案是通过路径类型检查和异常处理可避免NotADirectoryError。在调用os.listdir()等目录操作前，应使用os.path.isdir()或pathlib.Path.is_dir()判断路径是否为目录，并结合exists()确认路径存在，同时用try-except捕获NotADirectoryError、FileNotFoundError等异常，确保程序健壮性。

在使用Python处理文件和目录时，经常会遇到 NotADirectoryError 错误，提示“不是目录”。这个错误通常发生在你试图将一个**非目录路径**（比如普通文件）当作目录来操作，例如调用 os.listdir() 或 os.chdir() 时。下面介绍常见场景、错误原因以及如何正确处理。

什么是 NotADirectoryError？

当你尝试对一个本应是目录的路径执行目录相关操作，但该路径实际上是一个文件或其他非目录对象时，Python会抛出 NotADirectoryError。典型错误信息如下：

常见引发错误的操作

以下几种操作容易触发此错误：

• os.listdir('somefile.txt')：试图列出一个文件的内容
• os.chdir('somefile.txt')：试图切换到一个文件路径
• os.walk('somefile.txt')：将文件作为根目录遍历
• 使用 pathlib.Path 调用 .iterdir() 在文件上

示例代码：

立即学习“Python免费学习笔记（深入）”；

import os
os.listdir('config.log')  # 如果 config.log 是文件，报错 NotADirectoryError

如何安全地处理路径并避免错误

关键是**在操作前验证路径类型**。可以使用 os.path.isdir() 或 pathlib.Path.is_dir() 来判断是否为目录。

推荐做法：

挖错网

一款支持文本、图片、视频纠错和AIGC检测的内容审核校对平台。

28

查看详情

import os
<p>path = 'data'</p><p>if os.path.isdir(path):
for item in os.listdir(path):
print(item)
else:
print(f"'{path}' 不是一个目录，可能是文件或不存在。")

使用 pathlib 的方式：

from pathlib import Path
<p>p = Path('data')</p><p>if p.is_dir():
for child in p.iterdir():
print(child)
elif p.exists():
print(f"'{p}' 是一个文件，无法遍历。")
else:
print(f"'{p}' 不存在。")

最佳实践建议

• 操作前检查类型：在调用 listdir、walk、chdir 前先判断是否为目录
• 结合 exists() 使用：先确认路径存在，再判断是文件还是目录
• 使用异常处理增强健壮性：

import os
<p>try:
items = os.listdir('unknown_path')
for item in items:
print(item)
except NotADirectoryError:
print("指定路径不是一个目录。")
except FileNotFoundError:
print("路径不存在。")
except PermissionError:
print("没有访问权限。")

这样即使出错也能友好提示，程序不会直接崩溃。

基本上就这些。只要在操作目录前做好路径类型判断，就能有效避免 NotADirectoryError。不复杂但容易忽略。

以上就是Python路径不是目录错误NotADirectoryError处理教程的详细内容，更多请关注php中文网其它相关文章！