os.getcwd() 返回进程启动时所在目录的绝对路径,非脚本目录或终端当前目录;可靠获取脚本目录应使用 os.path.dirname(os.path.abspath(__file__)) 或 pathlib.Path(__file__).parent。

os.getcwd() 返回的是什么路径
os.getcwd() 返回的是进程启动时所在的目录,不是脚本所在目录,也不是执行命令的终端当前目录(如果被其他程序调用的话)。很多人误以为它“总是返回当前脚本位置”,结果在打包成 exe、用 IDE 运行、或通过 systemd 启动时出错。
常见错误现象:FileNotFoundError 找不到同级配置文件;读取 config.json 失败,但明明和 .py 文件放在一起。
- 使用场景:适合临时生成日志、缓存等“与运行上下文相关”的路径,不适合定位项目内固定资源
- 它返回的一定是绝对路径(Windows 下带盘符,Linux/macOS 下以
/开头) - 如果你需要的是“这个 Python 文件在哪”,得用
os.path.dirname(os.path.abspath(__file__))
怎么可靠获取当前 Python 文件所在目录
靠 __file__ + os.path.abspath 组合才是稳定方案。它不依赖运行方式,无论你是双击运行、命令行执行、PyCharm 调试,还是用 python -m 模块方式启动,都指向源文件物理位置。
示例:
立即学习“Python免费学习笔记(深入)”;
import os<br>script_dir = os.path.dirname(os.path.abspath(__file__))<br>config_path = os.path.join(script_dir, 'config.json')
-
__file__是相对路径(如./utils/load.py)或绝对路径(取决于怎么运行),必须用os.path.abspath归一化 - 不要用
os.getcwd() + '/utils/load.py'拼接——路径分隔符可能错,且os.getcwd()本身不可靠 - Python 3.4+ 更推荐
pathlib.Path(__file__).parent,更简洁、跨平台
相对路径转绝对路径的两种安全写法
相对路径只有结合一个基准目录才有意义。直接对字符串做 os.path.join('data', 'input.csv') 不会自动补全到项目根目录——它只是拼字符串,容易漏掉基准。
- 错误写法:
open('data/input.csv')—— 基准是os.getcwd(),不可控 - 正确做法 1(基于脚本位置):
os.path.join(os.path.dirname(os.path.abspath(__file__)), 'data', 'input.csv') - 正确做法 2(基于项目根目录):先定义
ROOT_DIR = os.path.dirname(os.path.dirname(os.path.abspath(__file__))),再拼子路径 - 注意:所有路径拼接必须用
os.path.join或pathlib.Path /,别用+或/字符串拼接,Windows 会崩
os.path.relpath 的实际用途和陷阱
os.path.relpath 不是用来“让路径变短”的装饰函数,而是解决“已知两个绝对路径,求从 A 到 B 的相对跳转表达”。比如生成 HTML 中的 ../static/css/main.css 这类引用。
常见误用:拿 os.path.relpath('config.json') 单独调用,结果返回 config.json(因为默认 from 当前工作目录),看似正常,上线后就失效。
- 必须传两个参数:
os.path.relpath(target, start),且两者都应为绝对路径 - 它不检查文件是否存在,也不做任何 IO,纯字符串计算
- 在构建工具或生成配置文件时有用,日常读写文件几乎不需要它
路径这事,靠猜不如靠 os.path.abspath 多打一行;想省事用 pathlib,但得记住 __file__ 是唯一可信锚点。










