本文介绍使用pathlib模块优雅地跨目录定位同名sql文件，解决windows下驱动器路径拼接错误问题，并构建可复用的数据提取与导出流程。
本文介绍使用pathlib模块优雅地跨目录定位同名sql文件，解决windows下驱动器路径拼接错误问题，并构建可复用的数据提取与导出流程。
在多目录协作的Python项目中（如python-files/、sql-files/、extract-files/并列存放），常需根据当前运行脚本的名称，自动读取同名SQL文件并写入对应CSV结果。但直接使用os.path.join()拼接路径时，容易因Windows驱动器路径语义差异引发FileNotFoundError——例如'c:Userschalesql-filessource1.sql'实际被解释为“C盘当前目录下的相对路径”，而非绝对路径'C:Userschalesql-filessource1.sql'。
根本原因在于：os.path.join("C:", "Users", ...) 生成的是驱动器相对路径（等价于 C:Users...），它依赖C盘当前工作目录，而非根目录；而os.path.join("C:\", "Users", ...)才明确指向绝对路径。手动处理驱动器符号易出错且缺乏跨平台兼容性。
推荐统一采用现代、面向对象的pathlib方案，代码更简洁、语义更清晰、且天然支持跨平台：
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
from pathlib import Path
import pandas as pd
# 获取当前脚本路径对象
script_path = Path(__file__)
# 向上两级到达项目根目录（即 C:Userschale）
root = script_path.parent.parent
# 构建目标SQL文件路径：root/sql-files/{脚本名}.sql
sql_file = root / "sql-files" / f"{script_path.stem}.sql"
# 构建输出CSV路径：root/extract-files/{脚本名}.csv
csv_file = root / "extract-files" / f"{script_path.stem}.csv"
print(f"SQL路径: {sql_file}")
print(f"CSV路径: {csv_file}")
# 安全读取SQL文件（建议添加异常处理）
try:
with sql_file.open("r", encoding="utf-8") as f:
query = f.read()
# 示例：执行SQL查询（需配合数据库连接）
# df = pd.read_sql(query, connection)
# 示例：模拟数据处理后保存为CSV
# df.to_csv(csv_file, index=False)
print(f"✅ 已成功定位SQL文件：{sql_file.name}")
except FileNotFoundError:
print(f"❌ SQL文件未找到：{sql_file}")
except Exception as e:
print(f"❌ 处理失败：{e}")
关键优势说明：
- script_path.parent.parent 明确向上遍历，避免字符串分割与索引错误；
- / 运算符重载使路径拼接直观自然，pathlib 自动处理分隔符与驱动器逻辑；
- script.stem 安全获取无扩展名的文件名（比split('.')[0]更健壮，兼容file.v2.py等）；
- 所有路径均为Path对象，支持.exists(), .is_file(), .open()等链式操作，提升可读性与可靠性。
注意事项：
⚠️ 确保项目结构严格匹配预期（python-files/、sql-files/、extract-files/同级）；
⚠️ 生产环境务必添加try-except捕获FileNotFoundError和编码异常；
⚠️ 若脚本可能被导入而非直接运行，__file__仍有效，但需注意工作目录变化——pathlib基于__file__的绝对路径，不受os.chdir()影响，更具鲁棒性。
通过pathlib替代os.path，不仅规避了Windows路径陷阱，更让路径操作从“字符串拼接”升维为“对象导航”，是Python 3.4+项目的标准实践。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
