Python 文件路径详解：绝对路径、相对路径与 pathlib

>>> path = "C:\Users\name"
SyntaxError: (unicode error) 'unicodeescape' codec can't decode bytes...

解决方案：

1. 最佳实践：永远不要手动拼接路径字符串！使用 Python 标准库提供的工具，它们会自动处理分隔符。

使用双反斜杠：每个反斜杠写两次，转义自身。

path = "C:\\Users\\name\\file.txt"

使用正斜杠：Windows 也接受正斜杠作为路径分隔符，这是最省事的办法。

path = "C:/Users/name/file.txt"

使用原始字符串：在字符串前加 r，让反斜杠保持原样。

path = r"C:\Users\name\file.txt"

3. 传统方式：os.path 模块

os.path 是 Python 早期就有的路径操作模块，提供了一系列函数来处理路径字符串。

常用函数

示例代码

import os

# 拼接路径
folder = "data"
filename = "input.txt"
file_path = os.path.join(folder, filename)
print(file_path)
# 输出：data/input.txt（Windows 上为 data\input.txt）

# 获取绝对路径
abs_path = os.path.abspath(file_path)
print(abs_path)
# 例如：/home/username/project/data/input.txt

# 检查文件是否存在
if os.path.exists(file_path):
    print("文件存在")
else:
    print("文件不存在")

# 分离文件名和扩展名
name, ext = os.path.splitext("report.pdf")
print(name) # report
print(ext) # .pdf

# 获取家目录下的文件
home_file = os.path.expanduser("~/documents/notes.txt")
print(home_file)
# /home/username/documents/notes.txt

注意事项

• os.path.join 只处理字符串拼接，不会检查路径是否真实存在。
• 所有函数都返回字符串，你需要自己管理字符串操作。

4. 现代方式：pathlib 模块

从 Python 3.4 开始，官方引入了 pathlib 模块，它将路径表示为对象，提供了更直观、更面向对象的 API。目前 pathlib 已经成为处理路径的首选方式。

核心类：Path

Path 可以代表文件或目录的路径。你可以通过传入字符串创建 Path 对象，然后使用 / 运算符拼接路径，就像在命令行中操作一样。

常用方法

示例代码

from pathlib import Path

# 创建 Path 对象
base_dir = Path("project")
data_file = base_dir / "data" / "input.txt"

# 使用 / 拼接
print(data_file)
# 输出：project/data/input.txt（自动使用系统分隔符）

# 获取绝对路径
abs_path = data_file.resolve()
print(abs_path)
# 例如：/home/username/project/data/input.txt

# 检查存在性
if data_file.exists():
    print("文件存在")
else:
    # 创建父目录（如果不存在）
    data_file.parent.mkdir(parents=True, exist_ok=True)
    # 然后可以创建文件...

# 获取文件信息
print("文件名:", data_file.name)      # input.txt
print("文件名 (无扩展):", data_file.stem) # input
print("扩展名:", data_file.suffix)     # .txt
print("父目录:", data_file.parent)     # project/data

# 遍历目录
for child in Path(".").iterdir():
    if child.is_file():
        print(f"文件：{child.name}")
    elif child.is_dir():
        print(f"目录：{child.name}")

# 使用 glob 查找所有 .txt 文件
for txt_file in Path("data").glob("*.txt"):
    print(txt_file)

# 读取/写入文件的简洁方式
Path("hello.txt").write_text("Hello, world!", encoding="utf-8")
content = Path("hello.txt").read_text(encoding="utf-8")
print(content)

为什么推荐 pathlib？

• 可读性强：路径操作像自然语言，/ 运算符直观。
• 面向对象：路径本身带有方法，无需到处调用 os.path 函数。
• 跨平台友好：内部自动处理分隔符，返回的字符串也是平台原生格式。
• 功能丰富：涵盖了几乎所有路径操作，甚至包括文件读写、目录创建等，减少了代码量。

5. 路径中的特殊符号

• . (当前目录)：在相对路径中，./file.txt 和 file.txt 是等价的，通常省略。
• .. (父目录)：用于向上回溯。例如 ../images/logo.png 表示从当前目录的父目录下的 images 文件夹中找 logo.png。
• ~ (用户家目录)：在 Unix-like 系统和 Windows 中，~ 都代表当前用户的家目录。在 Windows 上，它通常对应 C:\Users\用户名。Python 的 os.path.expanduser("~/file.txt") 和 pathlib.Path.home() / "file.txt" 能够跨平台正确处理这一扩展，让你轻松访问用户目录下的文件。

6. 常见错误

• 错误 1：在 Windows 上直接写 "C:\Users\name\file.txt" 导致转义问题。
  ✅ 应使用原始字符串或正斜杠。
• 错误 2：认为相对路径总是相对于脚本文件的位置。
  ✅ 实际上，相对路径是相对于'当前工作目录'，这一点将在第二部分详细说明。
• 错误 3：手动拼接路径字符串（如 folder + "/" + file），容易出错且跨平台兼容性差。
  ✅ 应使用 os.path.join 或 pathlib。

代码如何知道文件在哪里？

在上一部分中，我们学习了文件路径的基础知识。但有一个关键问题还没有解答：当我们在代码中使用相对路径（如 "data/input.txt"）时，Python 到底从哪个目录开始寻找这个文件？答案取决于 当前工作目录。如果不理解这个概念，你的程序很可能在别人的电脑上运行失败，甚至在自己电脑上换个位置运行就会报错。

1. 当前工作目录（CWD）

当前工作目录（Current Working Directory，简称 CWD）是操作系统为每个正在运行的进程维护的一个目录。当你在程序中使用相对路径时，Python 会在这个目录下查找文件。可以把它理解为程序运行时的'家'。

如何获取当前工作目录？

使用 os.getcwd() 或 pathlib.Path.cwd()：

import os
from pathlib import Path

print(os.getcwd())
# 例如：C:\Users\Alice\project
print(Path.cwd())
# 同样输出当前工作目录

当前工作目录是如何确定的？

• 如果你在命令行中运行脚本，比如 python C:\project\script.py，那么当前工作目录通常是命令行当前所在的目录，而不是脚本所在的目录。
• 如果你在 IDE（如 PyCharm、VS Code）中运行，当前工作目录通常是项目根目录，具体取决于 IDE 的设置。
• 如果你双击运行脚本，当前工作目录可能是脚本所在的目录，但也不一定（取决于系统）。

这种不确定性正是问题的根源。请看下面的例子：

假设项目结构如下：

C:\project\
│   ├── script.py
└── data\
    └── input.txt

script.py 内容：

with open("data/input.txt", "r") as f:
    print(f.read())

情况一：在命令行中，先切换到 C:\project 目录，然后运行 python script.py → 成功，因为当前工作目录是 C:\project，相对路径 data/input.txt 可以正确找到。

情况二：在命令行中，当前目录是 C:\，然后运行 python project\script.py → 失败！因为当前工作目录是 C:\，Python 会尝试打开 C:\data\input.txt，但文件实际在 C:\project\data\input.txt，所以抛出 FileNotFoundError。

情况三：在 IDE 中，如果 IDE 将工作目录设置为 C:\project，则成功；如果设置为其他目录，则失败。

由此可见，依赖当前工作目录的相对路径是不稳定的。为了让程序在任何环境下都能正确找到文件，我们需要一种不依赖 CWD 的方法。

2. 使用 file 构建绝对路径

__file__ 是一个特殊的 Python 变量，它包含了当前脚本文件的绝对路径（在大多数情况下）。利用这个变量，我们可以获取脚本所在的目录，然后基于这个目录构建相对于脚本的路径。

如何获取脚本所在目录？

import os
from pathlib import Path

# 传统方式
script_dir = os.path.dirname(os.path.abspath(__file__))
file_path = os.path.join(script_dir, "data", "input.txt")

# 现代方式（pathlib）
script_dir = Path(__file__).resolve().parent
file_path = script_dir / "data" / "input.txt"

关键点：

• os.path.abspath(__file__) 或 Path(__file__).resolve() 确保我们得到的是绝对路径，避免 __file__ 在某些情况下是相对路径。
• 然后通过 os.path.dirname 或 .parent 提取目录部分。
• 最后拼接目标文件的相对路径。

现在，无论当前工作目录是什么，file_path 总是指向 script.py 同级的 data/input.txt。这样程序就具备了可移植性——只要整个项目文件夹被完整移动，内部相对关系不变，文件就能被找到。

完整的示例

import os
from pathlib import Path

# 基于 __file__ 构建路径
script_dir = Path(__file__).resolve().parent
data_file = script_dir / "data" / "input.txt"

# 读取文件
try:
    with open(data_file, "r", encoding="utf-8") as f:
        content = f.read()
    print(content)
except FileNotFoundError:
    print(f"文件不存在：{data_file}")

注意事项

• 在交互式环境（如 Jupyter Notebook、REPL）中，__file__可能不存在或不可用。这种情况下，你可能需要手动指定路径或使用其他方法。
• 如果使用打包工具（如 PyInstaller）将脚本打包成可执行文件，__file__的行为可能会变化，但通常仍有替代方案（如 sys.executable 或 sys.argv[0]）。

3. 基于 CWD 与基于 __file__的区别

什么时候可以放心使用 CWD？

• 当你的程序需要与用户交互，比如让用户通过命令行指定输入文件路径，或者读取用户目录下的文件（如 ~/Documents/），此时使用基于 CWD 或绝对路径是合适的。
• 如果只是临时写个脚本，且你确保总是在特定目录下运行，也可以偷懒。

但作为通用原则，对于项目内部的资源文件（如数据文件、配置文件、日志文件），强烈建议基于 __file__ 构建路径。

4. 高级技巧：让 pathlib 更简洁

pathlib 不仅让路径操作更优雅，还能一步到位完成'获取脚本目录 + 拼接路径'的操作：

from pathlib import Path

# 获取当前脚本所在目录
BASE_DIR = Path(__file__).resolve().parent

# 定义常用目录
DATA_DIR = BASE_DIR / "data"
LOG_DIR = BASE_DIR / "logs"
CONFIG_FILE = BASE_DIR / "config" / "settings.ini"

# 使用
data_file = DATA_DIR / "input.txt"
content = data_file.read_text(encoding="utf-8")

你甚至可以将 BASE_DIR 定义为模块级别的常量，在整个项目中复用。

处理执行文件被打包的情况

如果你用 PyInstaller 打包成单文件可执行程序，运行时 __file__ 可能指向临时解压目录。此时可以用 sys.executable 或 sys.argv[0] 来定位可执行文件的位置，但需要额外处理。不过对于初学者，先掌握常规用法即可。

5. 修改当前工作目录（谨慎使用）

虽然我们不建议依赖 CWD，但有时确实需要临时改变工作目录。可以使用 os.chdir(path) 或 Path.chdir()。

import os
os.chdir("/path/to/new/dir")
print(os.getcwd())  # 已改变

但是要小心：改变工作目录会影响整个进程，可能导致其他相对路径失效。除非有充分理由，否则应避免。

6. 总结

通过本部分的学习，你应该明白了：

• 当前工作目录是相对路径的参照点，但它是不稳定的。
• 使用 __file__ 可以构建相对于脚本文件的绝对路径，让你的程序具备可移植性。
• 推荐使用 pathlib 来简化路径操作。

现在，我们已经解决了'文件在哪里'的问题，可以安全地定位到任何文件。关于文件内容的正式读取与写入操作，将在后续课程中详细展开。