【Python】解决Python报错：IsADirectoryError: [Errno 21] Is a directory

🧑 博主简介：阿里巴巴嵌入式技术专家，深耕嵌入式+人工智能领域，具备多年的嵌入式硬件产品研发管理经验。

📒 博客介绍：分享嵌入式开发领域的相关知识、经验、思考和感悟，欢迎关注。提供嵌入式方向的学习指导、简历面试辅导、技术架构设计优化、开发外包等服务，有需要可加文末联系方式联系。

💬 博主粉丝群介绍：① 群内高中生、本科生、研究生、博士生遍布，可互相学习，交流困惑。② 热榜top10的常客也在群里，也有数不清的万粉大佬，可以交流写作技巧，上榜经验，涨粉秘籍。③ 群内也有职场精英，大厂大佬，可交流技术、面试、找工作的经验。④ 进群免费赠送写作秘籍一份，助你由写作小白晋升为创作大佬。⑤ 进群赠送CSDN评论防封脚本，送真活跃粉丝，助你提升文章热度。有兴趣的加文末联系方式，备注自己的CSDN昵称，拉你进群，互相学习共同进步。

问题背景

IsADirectoryError: [Errno 21] Is a directory 是 Python 内置异常的一部分，它在试图执行需要文件路径而提供了目录路径的操作时发生。具体的错误信息 IsADirectoryError: [Errno 21] Is a directory: 'xxx' 表示操作系统返回错误编号 21，表示目标是一个目录而非文件。这种错误常见于文件读取、写入或者删除等操作中。

以下是一些常见的解决方案和示例代码来处理 IsADirectoryError: [Errno 21] Is a directory 错误。

解决方案

1. 确保文件路径指向的是一个文件

在尝试打开或操作路径之前，使用 os.path.isfile 和 os.path.isdir 方法检查路径是否是文件或目录。

import os

file_path = 'example_directory'

if os.path.isfile(file_path):
    with open(file_path, 'r') as file:
        content = file.read()
        print(content)
else:
    print(f"The path '{file_path}' is not a file.")

2. 递归遍历目录时跳过目录

在递归遍历目录进行文件操作时，确保跳过目录。

import os

directory = 'example_directory'

for root, dirs, files in os.walk(directory):
    for name in files:
        file_path = os.path.join(root, name)
        try:
            with open(file_path, 'r') as file:
                content = file.read()
                print(content)
        except IsADirectoryError:
            print(f"'{file_path}' is a directory, skipping.")

3. 捕获并处理异常

使用 try-except 块捕获 IsADirectoryError 异常，并根据需要处理该异常。

file_path = 'example_directory'

try:
    with open(file_path, 'r') as file:
        content = file.read()
        print(content)
except IsADirectoryError as e:
    print(f"Error: {e}. The path '{file_path}' is a directory, not a file.")

4. 确保在删除文件时不删除目录

在删除文件时，确保路径指向的是文件而不是目录。

import os

file_path = 'example_directory'

if os.path.isfile(file_path):
    os.remove(file_path)
    print(f"Removed file: {file_path}")
else:
    print(f"The path '{file_path}' is not a file.")

5. 使用合适的函数进行目录操作

针对目录使用合适的函数（例如 os.rmdir 而不是 os.remove）。

import os

dir_path = 'example_directory'

if os.path.isdir(dir_path):
    os.rmdir(dir_path)
    print(f"Removed directory: {dir_path}")
else:
    print(f"The path '{dir_path}' is not a directory.")

示例与应用

我们来通过几个完整的示例展示解决方案。

示例 1：避免操作目录而非文件

import os

file_path = 'example_directory'

if os.path.isfile(file_path):
    with open(file_path, 'r') as file:
        content = file.read()
        print(content)
else:
    print(f"The path '{file_path}' is not a file.")

示例 2：递归遍历目录时跳过目录

import os

directory = 'example_directory'

for root, dirs, files in os.walk(directory):
    for name in files:
        file_path = os.path.join(root, name)
        try:
            with open(file_path, 'r') as file:
                content = file.read()
                print(content)
        except IsADirectoryError:
            print(f"'{file_path}' is a directory, skipping.")

示例 3：捕获并处理 IsADirectoryError

file_path = 'example_directory'

try:
    with open(file_path, 'r') as file:
        content = file.read()
        print(content)
except IsADirectoryError as e:
    print(f"Error: {e}. The path '{file_path}' is a directory, not a file.")

示例 4：确保在删除文件时不删除目录

import os

file_path = 'example_directory'

if os.path.isfile(file_path):
    os.remove(file_path)
    print(f"Removed file: {file_path}")
else:
    print(f"The path '{file_path}' is not a file.")

示例 5：使用合适的函数进行目录操作

import os

dir_path = 'example_directory'

if os.path.isdir(dir_path):
    os.rmdir(dir_path)
    print(f"Removed directory: {dir_path}")
else:
    print(f"The path '{dir_path}' is not a directory.")

总结

IsADirectoryError: [Errno 21] Is a directory: 'xxx' 错误表明尝试在需要文件的操作中使用了一个目录。通过确保路径指向适当的文件或目录、在递归遍历时跳过目录、捕获并处理异常以及使用合适的函数进行目录操作，我们可以有效避免并解决此类错误。

希望本文对你理解和解决 IsADirectoryError: [Errno 21] Is a directory: 'xxx' 错误有所帮助。如果你有任何问题或建议，欢迎在评论区留言讨论！