Python 相对路径问题：“No such file or directory“，原因及解决方法

如果你取相对路径不是在主文件里，可能就会有相对路径问题："No such file or directory"。
因为 python 的相对路径，相对的都是主文件。
如下目录结构：

| -- main.py
     | -- conf.py
     | -- start.png
| -- config.txt

main.py 是主文件。
conf.py 里引用 config.txt 用相对路径。
如果用 . 或 . . 相对的是 main.py，所以用 "./config.txt"，相对于 main.py 是同一个目录下。
. 指当前文件所在的文件夹，. . 指当前文件的上一级目录。

[ 文章推荐 ]
Python 地图篇 - 使用 pyecharts 绘制世界地图、中国地图、省级地图、市级地图实例详解

引言

在 Python 编程中，我们经常会遇到各种错误消息。其中一个常见的错误是" No such file or directory "。这个错误提示意味着代码中引用的文件或目录不存在。本文将介绍一些可能导致该错误的常见场景，并提供详细的解释和示例代码，以帮助读者更好地理解和解决这个问题。

😃😄 ❤️ ❤️ ❤️

1. 介绍

在 Python 编程中，我们经常需要读取、写入或操作文件。然而，当代码中引用的文件或目录不存在时，就会触发" No such file or directory "错误。这个错误提示意味着 Python 无法找到所需的文件或目录。

2. 文件路径错误导致的" No such file or directory "错误

在这个部分，我们将介绍一些可能导致" No such file or directory "错误的常见文件路径错误场景。

2.1 相对路径与绝对路径

Python 中有两种常见的文件路径表示方法：相对路径和绝对路径。如果使用了错误的路径表示方法，就可能导致" No such file or directory "错误。以下是一个示例：

# 错误示例，使用错误的相对路径
file_path = 'data/file.txt'
with open(file_path, 'r') as file:
# 文件操作

# 正确示例，使用正确的相对路径
file_path = './data/file.txt'
with open(file_path, 'r') as file:
# 文件操作

# 正确示例，使用绝对路径
file_path = '/path/to/file.txt'
with open(file_path, 'r') as file:
# 文件操作

2.2 文件名错误

另一个常见的错误是在文件名中包含错误的拼写或文件扩展名。如果文件名不正确， Python 无法找到对应的文件，从而导致" No such file or directory "错误。以下是一个示例：

# 错误示例，文件名错误
file_path = './data/myfile.tx'  # 错误的文件扩展名
with open(file_path, 'r') as file:
# 文件操作

# 正确示例，文件名正确
file_path = './data/myfile.txt'
with open(file_path, 'r') as file:
# 文件操作

2.3 文件所在目录错误

如果代码中引用的文件所在目录不存在，也会触发" No such file or directory "错误。请确保在引用文件之前，所需的目录已经存在。以下是一个示例：

# 错误示例，文件所在目录不存在
file_path = './data/myfile.txt'  # data目录不存在
with open(file_path, 'r') as file:
# 文件操作

# 正确示例，文件所在目录存在
import os

directory = './data'
if not os.path.exists(directory):
os.makedirs(directory)

file_path = './data/myfile.txt'
with open(file_path, 'r') as file:
# 文件操作

3. 权限问题导致的" No such file or directory "错误

除了路径问题外，文件的权限设置也可能导致" No such file or directory "错误。如果文件所在的目录对于当前用户不可读或不可写， Python 将无法访问文件，从而触发该错误。以下是一个示例：

# 错误示例，没有读取文件的权限
file_path = './data/myfile.txt'
with open(file_path, 'r') as file:
# 文件操作

# 正确示例，设置正确的文件权限
file_path = './data/myfile.txt'
with open(file_path, 'w') as file:
# 文件操作

4. 文件类型错误导致的" No such file or directory "错误

最后，如果代码中引用的对象既不是文件也不是目录，就会触发" No such file or directory "错误。请确保你正在引用正确类型的对象。以下是一个示例：

# 错误示例，引用了不存在的目录
import os

directory_path = './data'
if os.path.isfile(directory_path):
with open(directory_path, 'r') as file:


# 文件操作
else:
print("目录不存在")

# 正确示例，引用了存在的目录
import os

directory_path = './data'
if os.path.isdir(directory_path):
# 目录操作
else:
print("目录不存在")

5. 解决方案和最佳实践

为了解决" No such file or directory "错误，我们可以采取以下解决方案和最佳实践：

• 确保使用正确的文件路径表示方法（相对路径或绝对路径）。
• 检查文件名是否正确，包括拼写和文件扩展名。
• 确保引用的文件所在目录已经存在，如果不存在则创建。
• 检查文件的权限设置，确保对于当前用户具有足够的读写权限。
• 确保引用的对象是正确的类型（文件或目录）。

6. 结论

" No such file or directory "错误是由于代码中引用的文件或目录不存在而触发的。本文介绍了一些可能导致该错误的常见场景，并提供了详细的解释和示例代码。通过遵循解决方案和最佳实践，我们可以更好地处理这个错误，并编写更可靠和健壮的 Python 代码。