Python中的文件路径是文件读写、配置加载、图片处理以及项目资源管理中经常遇到的问题。相比直接写死完整路径，相对路径更加灵活，尤其适合项目代码在不同电脑、不同目录甚至不同操作系统之间迁移。
理解Python相对路径的关键，不只是记住./和../的写法，还需要掌握“相对谁而言”的概念。路径的解析通常与程序当前工作目录有关，而不是简单地以当前Python文件所在目录为基准。
一、什么是Python相对路径
相对路径是相对于某个基准目录描述文件或文件夹位置的路径。它不会从磁盘根目录开始完整描述文件位置，而是通过当前目录和目录层级关系定位目标。
例如项目结构如下：
my_project/
├── main.py
├── config/
│ └── settings.json
└── data/
└── users.csv如果程序当前工作目录是my_project，那么访问data/users.csv时可以写成：
file_path = "data/users.csv"这里的data/users.csv就是相对路径。
相对于当前目录，还可以使用特殊符号表示目录关系：
. 当前目录
.. 上一级目录例如：
"./data/users.csv"表示当前目录下的data/users.csv。
而：
"../data/users.csv"表示当前目录的上一级目录中存在data目录。
需要特别注意，Python中的相对路径通常是**相对于当前工作目录（Current Working Directory，CWD）**进行解析，而不是天然相对于.py文件所在目录。
二、Python相对路径的基本语法
最简单的相对路径可以直接使用字符串：
path = "data/test.txt"Windows环境下也可以使用反斜杠：
path = "data\test.txt"不过在实际项目中，更推荐使用正斜杠或者Python提供的路径处理工具：
path = "data/test.txt"Python通常能够正确处理这种写法，因此代码更加简洁，也可以减少转义字符带来的问题。
1. 使用当前目录符号
.表示当前目录。
例如：
path = "./data/test.txt"它和下面的写法通常表示同一个位置：
path = "data/test.txt"因此.并不是必须的，但在需要明确表达“从当前目录开始”时比较直观。
2. 使用上一级目录
..表示当前目录的父目录。
例如：
path = "../config/settings.json"假设当前工作目录是：
project/scripts/那么该路径实际指向：
project/config/settings.json多个..可以连续使用：
path = "../../data/test.csv"表示向上返回两级目录后，再进入data目录。
3. 使用多级相对路径
项目中的文件通常不会只存在一层目录，因此相对路径也可以包含多个目录：
path = "resources/images/logo.png"对应的目录结构可能是：
project/
├── resources/
│ └── images/
│ └── logo.png
└── main.py只要当前工作目录是project，上述路径即可定位到目标文件。
三、如何查看Python当前工作目录
处理相对路径之前，建议先确认程序当前到底在哪个目录运行。
可以使用os.getcwd()：
import os
print(os.getcwd())例如输出：
C:UsersTomproject说明当前工作目录就是：
C:UsersTomproject此时：
open("data/test.txt")实际上访问的是：
C:UsersTomprojectdata est.txt也可以使用pathlib查看：
from pathlib import Path
print(Path.cwd())现代Python项目更推荐使用pathlib进行路径操作，因为它提供了更加面向对象的API。
四、Python相对路径与当前脚本目录的区别
这是使用相对路径时最容易产生误解的地方。
假设目录结构为：
project/
├── main.py
└── data/
└── test.txtmain.py内容：
from pathlib import Path
print(Path.cwd())如果在project目录中执行：
python main.py那么当前工作目录通常是：
project/此时：
Path("data/test.txt")可以正常定位文件。
但是，如果从其他目录执行：
python project/main.py当前工作目录可能仍然是执行命令时所在的目录，而不是project目录。
因此：
Path("data/test.txt")未必能够找到project/data/test.txt。
如果真正需要的是“相对于当前Python脚本所在目录”的路径，就应该明确获取脚本目录。
使用pathlib可以这样写：
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent
file_path = BASE_DIR / "data" / "test.txt"
print(file_path)这样无论从哪个目录启动程序，只要项目文件结构没有发生变化，路径都可以稳定定位到脚本目录下的data/test.txt。
五、使用pathlib处理相对路径
pathlib是Python中非常实用的路径处理模块。
基本写法：
from pathlib import Path
path = Path("data") / "test.txt"
print(path)结果类似：
data/test.txt这种写法比手动拼接字符串更加清晰。
例如：
from pathlib import Path
base_dir = Path("project")
file_path = base_dir / "data" / "users.csv"
print(file_path)这里的/不是普通字符串拼接，而是Path对象专门提供的路径连接操作。
判断文件是否存在
from pathlib import Path
path = Path("data/test.txt")
if path.exists():
print("文件存在")
else:
print("文件不存在")还可以分别判断文件和目录：
if path.is_file():
print("这是文件")
if path.is_dir():
print("这是目录")获取绝对路径
相对路径可以通过resolve()转换为绝对路径：
from pathlib import Path
path = Path("data/test.txt")
print(path.resolve())这对于排查“文件明明存在但程序找不到”的问题非常有帮助。
六、使用相对路径读取文件
Python读取文本文件时，可以直接传入相对路径：
with open("data/test.txt", "r", encoding="utf-8") as f:
content = f.read()
print(content)如果文件位于上一级目录：
with open("../data/test.txt", "r", encoding="utf-8") as f:
content = f.read()使用pathlib则可以写成：
from pathlib import Path
file_path = Path("data/test.txt")
with file_path.open("r", encoding="utf-8") as f:
content = f.read()
print(content)对于简单项目，两种方式都可以使用；对于目录结构复杂的项目，pathlib通常更加便于维护。
七、相对路径创建文件和目录
相对路径不仅可以读取文件，也可以用于创建文件。
例如：
from pathlib import Path
output_dir = Path("output")
output_dir.mkdir(exist_ok=True)
file_path = output_dir / "result.txt"
file_path.write_text("处理完成", encoding="utf-8")如果需要同时创建多级目录，可以使用：
output_dir.mkdir(parents=True, exist_ok=True)例如：
from pathlib import Path
path = Path("output/2026/10/result.txt")
path.parent.mkdir(parents=True, exist_ok=True)
path.write_text("数据处理结果", encoding="utf-8")这样即使output/2026/10之前不存在，也会自动创建对应目录。
八、Python相对路径中的常见错误
1. 把相对路径理解成相对于.py文件
这是最常见的问题。
例如：
open("config/config.json")它默认参考的是当前工作目录，而不是当前.py文件所在目录。
如果程序经常从不同位置启动，建议使用：
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent
config_path = BASE_DIR / "config" / "config.json"2. Windows路径中的反斜杠问题
Windows路径经常写成：
path = "C:
ew est.txt"这种写法可能出现问题，因为
、 等字符具有特殊含义。
可以使用原始字符串：
path = r"C:
ew est.txt"也可以使用双反斜杠：
path = "C:\new\test.txt"更推荐使用pathlib：
from pathlib import Path
path = Path("C:/new/test.txt")或者：
path = Path("C:\new\test.txt")3. 路径大小写问题
不同操作系统对路径大小写的处理方式可能不同。
例如：
Data/test.txt和：
data/test.txt在某些环境下可能被视为相同路径，而在Linux等环境中通常是不同路径。
因此项目开发过程中应尽量保持目录和文件名称大小写统一。
4. 直接拼接路径字符串
不推荐这样写：
path = "data" + "/" + "test.txt"也不推荐到处手动拼接：
path = base_dir + "/" + folder + "/" + filename更好的方式是：
from pathlib import Path
path = Path(base_dir) / folder / filename这样代码更加清晰，也更容易适应不同操作系统。
九、实战：项目中正确使用相对路径
假设有一个数据处理项目：
data_project/
├── main.py
├── config/
│ └── config.json
├── data/
│ ├── input.csv
│ └── output.csv
└── logs/
└── app.log如果main.py需要读取配置文件，可以使用：
from pathlib import Path
import json
BASE_DIR = Path(__file__).resolve().parent
config_path = BASE_DIR / "config" / "config.json"
with config_path.open("r", encoding="utf-8") as f:
config = json.load(f)
print(config)读取输入数据：
input_path = BASE_DIR / "data" / "input.csv"
with input_path.open("r", encoding="utf-8") as f:
data = f.read()生成输出文件：
output_path = BASE_DIR / "data" / "output.csv"
output_path.write_text(data, encoding="utf-8")这种写法将项目根目录作为路径基准，可以避免程序因为启动位置变化而产生大量路径错误。
十、相对路径在不同运行环境中的注意事项
开发阶段直接运行Python文件时：
python main.py通常比较容易理解当前工作目录。
但实际项目可能通过IDE、定时任务、Docker、Web服务器或者其他脚本启动。不同启动方式可能改变当前工作目录。
例如IDE中的运行配置可能指定：
Working Directory = 项目目录而服务器启动脚本可能指定其他目录。
因此，不能单纯依赖：
Path("config/config.json")来确定项目内部资源的位置。
对于必须跟随代码文件移动的资源，通常更适合使用：
Path(__file__).resolve().parent作为基准目录。
如果路径本身来自用户输入、配置文件或命令行参数，则应尊重输入的路径语义，而不是强行转换成相对于脚本目录的路径。
十一、相对路径与绝对路径如何选择
绝对路径类似：
C:UsersTomprojectdata est.txtLinux系统中可能是：
/home/tom/project/data/test.txt它定位准确，但通常存在明显的环境依赖。
相对路径：
data/test.txt更加简洁，也方便项目迁移。
一般可以按照以下原则选择：
| 使用场景 | 推荐方式 |
|---|---|
| 项目内部固定资源 | 相对项目目录的路径 |
| 用户指定文件 | 保留用户提供的路径 |
| 临时脚本 | 简单相对路径即可 |
| 跨平台项目 | pathlib |
| 配置文件随代码部署 | __file__ + Path |
| 系统级固定目录 | 根据环境使用绝对路径 |
| 文件上传、下载目录 | 项目配置 + pathlib |
十二、推荐的Python路径处理方式
现代Python项目中，可以优先采用pathlib统一管理路径：
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent
DATA_DIR = BASE_DIR / "data"
CONFIG_DIR = BASE_DIR / "config"
LOG_DIR = BASE_DIR / "logs"
input_file = DATA_DIR / "input.csv"
config_file = CONFIG_DIR / "config.json"
log_file = LOG_DIR / "app.log"这样可以将目录结构集中管理，避免项目代码中出现大量分散的字符串路径。
如果项目规模较大，还可以进一步将基础目录、数据目录等路径放入配置模块中，减少路径硬编码。
十三、排查“找不到文件”的实用方法
遇到：
FileNotFoundError不要首先怀疑Python本身。可以按照以下步骤检查。
首先查看当前工作目录：
from pathlib import Path
print(Path.cwd())然后打印目标路径：
path = Path("data/test.txt")
print("相对路径：", path)
print("绝对路径：", path.resolve())接着检查文件是否存在：
print(path.exists())如果结果是：
False说明当前路径解析出来的位置没有目标文件。
如果项目要求以脚本目录为基准，可以进一步检查：
base_dir = Path(__file__).resolve().parent
path = base_dir / "data" / "test.txt"
print(path)