当前位置：首页 > news >正文

Python相对路径问题与工作目录和脚本目录

news 来源：原创 2025/4/24 10:35:25

最近在编写代码并调试时，笔者发现一个python相对路径和工作目录所引起的问题，即在不同的工作环境下（使用某IDE运行或者直接运行），想同的代码文件竟然会出现不同的结果。原因在于文件中相对路径的引用，是基于工作目录而不是脚本所在物理路径，所以在笔者根据脚本所在物理路径来进行寻址的时候，得到了不同的结果。

your_path = f'../da'
# 返回当前工作目录(Current Working Directory) 
# 由程序启动时的目录决定，可通过 os.chdir() 修改代表执行脚本时所在的目录
print(f"当前工作目录: {os.getcwd()}")#返回测试地址的绝对路径，根据当前工作目录和相对路径计算得出
print(f"解析后的路径: {Path(your_path).resolve()}")# 返回脚本文件所在的绝对目录路径，不受工作目录影响，始终指向脚本物理位置
print(f"当前脚本文件所在目录：{os.path.dirname(__file__)}")

解决该问题的方法是在程序运行时将当前工作目录与当前脚本所在目录设置为一致，在脚本文件最前面添加：

import os
# 设置工作目录为脚本所在目录
os.chdir(os.path.dirname(os.path.abspath(__file__)))

接下来，简单介绍一下Python中的相对路径问题。在 Python 中，相对路径索引主要用于文件和目录的访问，它允许你以相对于当前工作目录或某个特定目录的方式来指定文件或目录的位置。

基本概念

相对路径 ：相对于某个起始目录的路径，起始目录通常是当前工作目录。例如，./file.txt 表示当前目录下的file.txt文件，../file.txt表示当前目录的父目录下的file.txt文件。
索引：在这里可以理解为通过相对路径来定位文件或目录的位置，以便进行读取、写入等操作。

使用场景

同级目录文件访问 ：如果要访问与当前脚本同级目录下的文件，可以直接使用文件名作为相对路径，如open("data.txt")，此时 Python 会从当前工作目录下查找data.txt文件。
子目录文件访问 ：当目标文件位于当前目录的子目录中时，相对路径需要包含子目录名。例如，要访问subdir子目录下的file.txt文件，可以使用open("subdir/file.txt")。
父目录文件访问 ：如果要访问父目录中的文件，需要使用..来表示父目录。例如，open("../file.txt")表示访问当前目录的父目录下的file.txt文件，open("../../file.txt")表示访问当前目录的祖父目录下的file.txt文件。

注意事项

当前工作目录 ：相对路径的解析基于当前工作目录，而当前工作目录可能并不总是脚本所在的目录。可以通过os.getcwd()方法获取当前工作目录，通过os.chdir()方法改变当前工作目录。
跨平台兼容性 ：在不同的操作系统中，路径分隔符可能不同，如 Windows 使用反斜杠\\，而 Linux 和 macOS 使用正斜杠/。在 Python 中，可以使用os.path模块来处理路径，以确保跨平台兼容性。例如，os.path.join("dir", "file.txt")会根据操作系统自动使用正确的路径分隔符。
路径拼接 ：当使用相对路径时，可以通过os.path.join()方法来拼接路径，以避免手动处理路径分隔符带来的错误。例如，os.path.join("..", "data", "file.txt")会生成../data/file.txt这样的路径。

相对路径索引方法

os.path模块 ：该模块提供了一组用于处理文件路径的函数。例如，os.path.relpath(path, start)可以返回从start目录到path的相对路径。如果start不指定，则默认为当前工作目录。os.path.abspath(path)可以将相对路径转换为绝对路径。
pathlib模块 ：从 Python 3.4 开始引入，提供了一种面向对象的文件系统路径处理方式。Path类可以方便地操作文件和目录路径。例如，Path("subdir/file.txt")表示当前目录下subdir子目录中的file.txt文件，Path("../file.txt")表示父目录下的file.txt文件。