本文介绍使用pathlib.path优雅处理跨目录文件路径的正确方法，解决windows下因驱动器相对路径导致的filenotfounderror问题，并提供可复用的数据处理模板。
本文介绍使用pathlib.path优雅处理跨目录文件路径的正确方法，解决windows下因驱动器相对路径导致的filenotfounderror问题，并提供可复用的数据处理模板。
在多层项目结构中（如 python-files/、sql-files/、extract-files/ 平级存放），常需根据当前运行的 .py 文件名自动定位同名 .sql 文件进行读取，再将处理结果写入对应 .csv。但直接拼接字符串或混用 os.path.join 与路径分割极易出错——尤其在 Windows 上，'C:foo'（无反斜杠）被解释为“驱动器 C 的当前目录下的相对路径”，而非绝对路径 'C:\foo'，这正是你遇到 FileNotFoundError 的根本原因。
✅ 推荐方案：全程使用 pathlib.Path（Python 3.4+ 标准库）
Path 对象天然支持运算符重载（/），能自动处理平台差异、规范化路径，并避免手动拼接引发的驱动器上下文丢失问题：
from pathlib import Path
import pandas as pd
# 1. 获取当前脚本的完整路径对象
script_path = Path(__file__)
# 2. 向上追溯两级：从 python-files → chale → 根目录（即 C:Userschale）
root = script_path.parent.parent
# 3. 构建目标 SQL 文件路径（自动处理 .py → .sql）
sql_path = root / 'sql-files' / f'{script_path.stem}.sql'
# 4. 构建输出 CSV 路径
extract_path = root / 'extract-files' / f'{script_path.stem}.csv'
print(f"当前脚本: {script_path}")
print(f"SQL 文件: {sql_path}")
print(f"输出 CSV: {extract_path}")
# ✅ 安全读取 SQL 文件（无需担心路径格式）
with sql_path.open('r', encoding='utf-8') as f:
query = f.read()
# 示例：执行 SQL 查询并保存为 CSV（需适配你的数据库连接逻辑）
# df = pd.read_sql(query, connection)
# df.to_csv(extract_path, index=False)
⚠️ 关键注意事项：
- 永远不要用 os.path.dirname(__file__).split('\') 手动解析路径：易受平台、路径分隔符、驱动器符号影响；
- 避免 os.path.join('C:', ...)：'C:' 是驱动器前缀，不是根目录，后续路径会被视为相对路径；
- 优先使用 Path(__file__).parent.parent：语义清晰、跨平台、抗干扰；
- 始终用 with open() 或 Path.open()：确保文件正确关闭，避免资源泄漏；
- 显式指定 encoding='utf-8'：防止读取 SQL 文件时出现中文乱码。
? 扩展建议：
若项目结构可能变化，可将 root 定义为环境变量或配置项；对 SQL 执行部分，建议封装成函数并加入异常处理（如 sql_path.exists() 校验）。此模式可无缝扩展至日志、配置、模板等多目录协同场景。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
