在 Python 中，处理相对路径（Relative Path）和绝对路径（Absolute Path）是文件操作中的常见需求，以下是详细的使用方法、区别及最佳实践。
核心概念
- 相对路径：相对于当前工作目录（Current Working Directory, CWD）的路径。
./data/file.txt或data/file.txt- ⚠️ 注意：相对路径依赖于脚本运行的位置，容易出错。
- 绝对路径：从根目录（Windows 是盘符如
C:，Linux 是 ）开始的完整路径。/home/user/project/data/file.txt或C:Usersuserprojectdatafile.txt- ✅ 推荐：在跨平台、跨环境运行时，尽量使用基于脚本所在目录的绝对路径。
获取当前工作目录
import os # 获取当前工作目录（即运行 python 命令时的目录） cwd = os.getcwd() print(cwd)
📌 注意：
os.getcwd()返回的是你运行脚本的目录，而不是脚本文件所在的目录！这是新手最容易混淆的地方。
基于脚本所在目录构建路径（推荐做法）
为了确保无论从哪里运行脚本,都能正确找到资源文件，应基于
脚本文件自身的位置来构建路径。
使用 os.path（传统方式）
import os
# 获取当前脚本文件的绝对路径
script_dir = os.path.dirname(os.path.abspath(__file__))
# 构建相对于脚本目录的路径
# 假设有一个 data 文件夹在脚本同级目录下
file_path = os.path.join(script_dir, 'data', 'file.txt')
print("脚本目录:", script_dir)
print("完整文件路径:", file_path)
使用 pathlib（现代推荐方式，Python 3.4+）
from pathlib import Path
# 获取当前脚本所在目录
script_dir = Path(__file__).parent.resolve()
# 构建路径
file_path = script_dir / 'data' / 'file.txt'
print("脚本目录:", script_dir)
print("完整文件路径:", file_path)
✅
pathlib更简洁、可读性更强，且跨平台兼容性好。
相对路径 vs 绝对路径操作示例
使用 os.path
import os
# 当前工作目录
print("当前工作目录:", os.getcwd())
# 相对路径转绝对路径
rel_path = "data/file.txt"
abs_path = os.path.abspath(rel_path)
print("相对路径转绝对路径:", abs_path)
# 判断路径是否存在
print("路径存在?", os.path.exists(abs_path))
使用 pathlib
from pathlib import Path
# 相对路径转绝对路径
rel_path = Path("data/file.txt")
abs_path = rel_path.resolve() # 或 Path.cwd() / rel_path
print("相对路径转绝对路径:", abs_path)
# 判断路径是否存在
print("路径存在?", abs_path.exists())
常见陷阱与注意事项
| 问题 | 说明 |
|---|---|
__file__ 可能不存在 |
在交互式解释器（如 Jupyter Notebook、IPython）中，__file__ 可能未定义，此时应使用 Path.cwd()。 |
| 符号链接（Symlink） | os.path.abspath() 不会解析符号链接，而 Path.resolve() 会解析，根据需求选择。 |
| 路径分隔符 | 不要手动拼接 或 ''，使用 os.path.join() 或 操作符（pathlib）自动处理跨平台问题。 |
| 编码问题 | 在 Windows 上，路径包含中文时，确保文件编码和系统编码一致，或使用 pathlib 避免部分问题。 |
最佳实践总结
- 优先使用
pathlib，代码更清晰。 - 始终基于脚本所在目录构建路径，而不是依赖当前工作目录。
- 使用
.resolve()或os.path.abspath()将相对路径转换为绝对路径，避免歧义。 - 在打包或部署时,使用
sys.argv[0]或__file__定位资源文件。
示例：完整可运行代码
from pathlib import Path
import sys
def get_script_path():
"""获取当前脚本的绝对路径"""
if hasattr(__builtins__, 'get_ipython'):
# 在 Jupyter Notebook 中
return Path.cwd()
else:
# 在普通 Python 脚本中
return Path(__file__).parent.resolve()
if __name__ == "__main__":
script_dir = get_script_path()
print(f"脚本所在目录: {script_dir}")
# 假设在脚本同级目录下有一个 config.ini 文件
config_file = script_dir / "config.ini"
if config_file.exists():
print(f"找到配置文件: {config_file}")
else:
print("配置文件不存在")
如有具体场景（如读取 CSV、图片、配置文件等），可提供更多细节，我会给出针对性建议。
首发原创文章，作者：王坚，如若转载，请注明出处：https://test.idctop.com/article/476464.html
