本文介绍如何在 python 项目中不依赖当前工作目录（pwd），而是基于入口脚本位置自动定位项目根目录，并安全访问任意子目录资源，避免硬编码路径或脆弱的 `os.chdir()` 操作。
在多层嵌套的 Python 项目中，开发者常面临一个典型痛点：VS Code 或终端可能在任意子目录下启动，而配置文件、共享模块或静态资源却固定存放在项目根目录下的特定子路径（如 ./config/、./src/ 或 ./data/）。若使用 os.getcwd() 获取当前路径再手动拼接 ../，不仅逻辑冗余、易出错，还严重破坏代码可移植性——一旦执行位置变化，路径即失效。
更 Pythonic 的解法是锚定入口文件（如 main.py 或 __main__.py）的位置，因为该文件通常位于项目结构中稳定、可预期的位置。Python 标准库中的 pathlib 提供了简洁、面向对象且跨平台的路径操作能力，是现代路径处理的首选。
✅ 推荐方案：基于 __file__ 定位项目根
from pathlib import Path
# 获取当前 Python 文件所在目录的绝对路径（即该脚本的父目录）
project_root = Path(__file__).resolve().parent
# 示例：访问根目录下的 config/main.txt
config_file = project_root / "config" / "main.txt"
print("Config path:", config_file.resolve())
# 安全读取（自动处理路径存在性）
if config_file.is_file():
with open(config_file, "r", encoding="utf-8") as f:
content = f.read()
print("Config loaded successfully.")
else:
raise FileNotFoundError(f"Expected config file not found: {config_file}")? 关键点说明： Path(__file__) 获取当前 .py 文件的路径对象； .resolve() 强制解析为绝对路径并规范化（自动处理符号链接、..、.），比 .absolute() 更健壮（后者不检查路径是否存在）； 使用 / 运算符拼接路径，语义清晰、无字符串拼接风险（自动处理分隔符）； 所有操作与当前工作目录（os.getcwd()）完全解耦——无论你在 project/src/utils/ 还是 project/tests/ 下运行脚本，project_root 始终指向 main.py 所在的父目录。
? 进阶技巧：通用化项目根探测（适用于包内模块）
若入口脚本不在项目根，而你希望统一以某个标志性目录名（如 src、app 或 .git）为锚点向上查找，可封装一个健壮的探测函数：
from pathlib import Path
def find_project_root(marker: str = ".git") -> Path:
"""
从当前文件所在目录开始向上遍历，寻找指定标记文件/目录（如 .git、pyproject.toml、README.md）
返回首个匹配的父目录路径；未找到则抛出 RuntimeError。
"""
current = Path(__file__).resolve().parent
while current != current.parent: # 防止到达根目录后无限循环
if (current / marker).exists():
return current
current = current.parent
raise RuntimeError(f"Project root with '{marker}' not found.")
# 使用示例：定位含 .git 的根目录
ROOT_DIR = find_project_root()
config_dir = ROOT_DIR / "config"此方法适用于大型项目（如 Poetry/Flit 管理的包），即使 main.py 在 src/myapp/ 中，也能精准定位到含 .git 的真正项目根。
⚠️ 注意事项与最佳实践
- 永远避免 os.chdir()：修改工作目录会干扰并发操作、日志路径、第三方库行为，属于反模式；
- 优先用 pathlib.Path，而非 os.path：前者类型安全、链式调用、跨平台一致；
- 始终校验路径有效性：用 .is_file()、.is_dir()、.exists() 显式检查，而非依赖异常捕获；
- 编码显式声明：打开文本文件时务必指定 encoding="utf-8"，避免平台默认编码差异；
- 环境变量辅助（可选）：对高度动态场景，可结合 os.getenv("PROJECT_ROOT") 提供覆盖能力，但不应作为默认路径来源。
通过以上方式，你的项目路径逻辑将变得确定、可测试、可复现——无论在本地开发、CI 构建还是 Docker 容器中运行，只要入口脚本位置不变，资源访问就始终可靠。
