python如何获取脚本所在的目录_python获取当前执行脚本文件所在路径

尼克

发布时间：2025-09-13 12:20:01

723人浏览过

来源于php中文网

原创

最推荐使用pathlib.Path(__file__).resolve().parent获取脚本所在目录，它在Python 3.4+中提供面向对象、跨平台且可读性强的路径操作，能可靠解析绝对路径并返回父目录，优于传统的os.path.dirname(os.path.abspath(__file__))方法。

python如何获取脚本所在的目录_python获取当前执行脚本文件所在路径

在Python中获取脚本所在的目录，最直接且推荐的方式是结合

os.path

模块的

abspath

和

dirname

函数，即

os.path.dirname(os.path.abspath(__file__))

。对于更现代的Python版本，

pathlib

模块提供了更面向对象且可读性更好的解决方案，如

pathlib.Path(__file__).resolve().parent

。这两种方法都能可靠地定位到当前执行脚本的物理目录，无论脚本是如何被调用或导入的。

解决方案

要获取当前Python脚本文件所在的目录，我们可以依赖Python内置的

__file__

特殊变量，它包含了当前模块的路径。然而，

__file__

本身可能是一个相对路径，尤其是在脚本以某种特定方式被调用时。因此，我们需要对其进行处理以确保获得绝对路径，并最终提取出目录部分。

使用

os.path

模块 (Python 2.x 和 3.x 兼容):

这是最传统也是最常用的方法。

立即学习“Python免费学习笔记（深入）”；

import os

# 1. 获取当前脚本文件的绝对路径
# __file__ 变量包含了当前脚本的路径，但它可能是相对路径。
# os.path.abspath() 会将其转换为绝对路径。
script_path = os.path.abspath(__file__)

# 2. 从绝对路径中提取目录部分
# os.path.dirname() 用于获取给定路径的目录名。
script_directory = os.path.dirname(script_path)

print(f"脚本的完整路径: {script_path}")
print(f"脚本所在的目录 (os.path): {script_directory}")

# 简洁写法：
# script_directory_concise = os.path.dirname(os.path.abspath(__file__))
# print(f"脚本所在的目录 (os.path 简洁): {script_directory_concise}")

使用

pathlib

模块 (Python 3.4+ 推荐):

pathlib

提供了面向对象的文件系统路径操作，代码通常更简洁、可读性更强，并且处理跨平台路径分隔符更加优雅。

from pathlib import Path

# 1. 创建一个Path对象表示当前脚本文件
# Path(__file__) 创建一个Path对象。
# .resolve() 方法类似于 os.path.abspath()，它会解析路径中的所有符号链接并返回绝对路径。
script_path_obj = Path(__file__).resolve()

# 2. 获取Path对象的父目录
# .parent 属性直接返回Path对象的父目录。
script_directory_obj = script_path_obj.parent

print(f"脚本的完整路径 (pathlib): {script_path_obj}")
print(f"脚本所在的目录 (pathlib): {script_directory_obj}")

# 如果需要字符串形式的路径：
# script_directory_str = str(script_directory_obj)
# print(f"脚本所在的目录 (pathlib 字符串): {script_directory_str}")

两种方法都能有效解决问题，

pathlib

在现代Python开发中越来越受欢迎，因为它将路径视为对象，提供了更直观的操作方式。

深入理解

__file__

：它在不同执行场景下的行为差异与潜在陷阱

__file__

这个内置变量，初看起来很简单，就是当前脚本的路径嘛。但实际用起来，它有时候确实会让人困惑，甚至掉进一些小坑。它不是一个简单的“当前文件绝对路径”的代名词，而更像是“当前模块被Python解释器加载时的源文件路径”。理解它在不同场景下的行为，对于我们正确获取脚本目录至关重要。

当你直接运行一个脚本，比如

python my_script.py

，

__file__

通常会包含

my_script.py

的路径。如果是在当前目录运行，它可能是相对路径

my_script.py

；如果从其他目录运行，比如

python /path/to/my_script.py

，那

__file__

就会是

/path/to/my_script.py

。

然而，当你的脚本作为模块被导入时，

__file__

的行为会有些许不同。它会指向被导入模块的

.py

文件路径，或者是其对应的

.pyc

（编译后的字节码）文件路径。这通常是绝对路径，但也并非总是如此。

更需要注意的是，在一些特殊场景下，

__file__

甚至可能不存在或不包含一个实际的文件路径。例如，在Python交互式解释器中，

__file__

是不存在的。如果你使用

exec()

函数执行一段代码，那段代码内部的

__file__

可能会是

或者一个临时的路径。

所以，我们不能盲目地相信

__file__

总是提供一个可直接使用的绝对路径。这就是为什么我们几乎总是需要用

os.path.abspath(__file__)

或者

Path(__file__).resolve()

来“净化”它。

abspath

会把任何相对路径转换为基于当前工作目录的绝对路径。而

resolve()

更进一步，它还会解析所有符号链接（软链接），确保你得到的是文件系统上真实的物理路径，这在处理部署或打包时尤其有用。

甲骨文AI协同平台

专门用于甲骨文研究的革命性平台

下载

不加处理直接使用

os.path.dirname(__file__)

，如果

__file__

是相对路径，那么你得到的目录也会是相对于当前工作目录的相对路径，而不是脚本自身的物理目录，这往往不是我们想要的结果。所以，先

abspath

（或

resolve

）再

dirname

（或

.parent

）是一个非常必要的步骤，它能规避大部分

__file__

带来的不确定性。

Python路径处理新旧对比：

os.path

与

pathlib

的选择与优势

在Python中处理文件路径，我们有

os.path

这个老牌选手，也有

pathlib

这个后起之秀。它们都能完成任务，但风格和理念却大相径庭。选择哪一个，往往取决于你的项目需求、Python版本以及个人偏好。

os.path

模块自Python诞生之初就存在，它提供了一系列函数来操作字符串形式的路径。它的优点是兼容性极佳，几乎所有的Python环境都能用。但它的缺点也很明显：

字符串操作：所有路径都被视为字符串，这意味着你需要频繁地拼接字符串、拆分字符串，代码容易变得冗长且容易出错，比如忘记
```
os.path.join()
```
而直接用
```
+
```
号连接路径，导致跨平台问题。
函数式：你需要调用各种函数来完成操作，比如
```
os.path.join()
```
、
```
os.path.dirname()
```
、
```
os.path.basename()
```
等，不够直观。
可读性：当路径操作链条较长时，代码可读性会下降，例如
```
os.path.join(os.path.dirname(os.path.abspath(__file__)), 'data', 'config.json')
```
。

而

pathlib

模块（Python 3.4+）则引入了面向对象的路径操作。它将路径视为对象，提供了更现代、更直观的API。它的优势在于：

面向对象：路径是一个
```
Path
```
对象，你可以直接在其上调用方法或使用属性，如
```
.parent
```
、
```
.name
```
、
```
.suffix
```
等。
操作符重载：它重载了
```
/
```
操作符，使得路径拼接变得异常简洁和自然，例如
```
Path(__file__).parent / 'data' / 'config.json'
```
，这简直是艺术！
链式调用：许多操作可以链式调用，使得代码更加紧凑和富有表达力。
跨平台：
```
Path
```
对象自动处理不同操作系统之间的路径分隔符差异，你无需担心Windows的
```
\
```
和Linux/macOS的
```
/
```
。
丰富的API：除了基本的路径操作，
```
pathlib
```
还提供了文件系统操作，如
```
.exists()
```
、
```
.is_file()
```
、
```
.mkdir()
```
、
```
.touch()
```
、
```
.read_text()
```
、
```
.write_bytes()
```
等，大大简化了文件操作。

对我来说，只要项目允许，我几乎总是倾向于使用

pathlib

。它的代码更优雅，更符合Python的“可读性”哲学。那种用

来拼接路径的感觉，简直是享受。当然，

os.path

仍然有它的用武之地，比如在一些需要与旧代码库高度兼容，或者处理一些非常底层的、需要字符串路径作为参数的系统调用时。但在日常的脚本开发和应用构建中，

pathlib

无疑是更现代、更强大的选择。它不仅让代码更清晰，也减少了因路径字符串操作而引入的潜在错误。

Python脚本跨平台路径获取：Windows、Linux和macOS的兼容性挑战与解决方案

编写Python脚本时，我们常常希望它能在不同的操作系统上无缝运行，而路径处理就是其中一个常见的跨平台挑战。Windows、Linux和macOS在文件系统路径的表示和行为上存在一些关键差异，如果处理不当，脚本可能在一个系统上运行良好，在另一个系统上却报错。

最明显的差异莫过于路径分隔符。Windows使用反斜杠

（例如

C:\Users\Admin\Documents

），而Linux和macOS则使用正斜杠

（例如

/home/user/documents

）。幸运的是，Python的

os.path

和

pathlib

模块在设计时就考虑到了这一点。

```
os.path.join()
```
函数会根据当前操作系统的规则自动选择正确的分隔符。
```
pathlib
```
模块的
```
Path
```
对象及其
```
/
```
操作符也是开箱即用地支持跨平台分隔符。你只需写
```
Path('my_dir') / 'my_file.txt'
```
，它在Windows上会生成
```
my_dir\my_file.txt
```
，在Linux上则是
```
my_dir/my_file.txt
```
。

另一个需要注意的点是文件系统大小写敏感性。Linux和macOS（默认情况下）的文件系统是大小写敏感的，

MyFile.txt

和

MyFile.txt

是两个不同的文件。而Windows的文件系统通常是大小写不敏感的，

MyFile.txt

和

MyFile.txt

会被视为同一个文件。这意味着在Linux上，如果你尝试打开

MyFile.txt

但实际文件是

MyFile.txt

，就会遇到

FileNotFoundError

。在Python代码中，我们通常需要确保文件路径的大小写与实际文件系统中的一致，或者在查找文件时进行大小写不敏感的比较（如果业务逻辑允许）。

Windows特有的盘符也是一个差异。Linux和macOS的文件系统是统一的根目录

，而Windows有

C:

D:

等盘符。

os.path.abspath()

和

pathlib.Path().resolve()

在Windows上处理带有盘符的路径时，会正确地将其解析为完整的绝对路径，无需我们额外操心。

为了确保路径获取的跨平台兼容性，关键在于始终使用Python提供的抽象层：

获取脚本目录：正如前面所述，
```
os.path.dirname(os.path.abspath(__file__))
```
或
```
Path(__file__).resolve().parent
```
是获取当前脚本所在目录的黄金标准。它们都会返回一个适用于当前操作系统的绝对路径。
构建路径：永远不要手动拼接路径字符串，而是使用
```
os.path.join()
```
或
```
pathlib
```
的
```
/
```
操作符。这能确保路径分隔符的正确性。
解析符号链接：在某些情况下，文件或目录可能是一个符号链接。
```
os.path.realpath()
```
或
```
pathlib.Path().resolve()
```
能够解析这些链接，返回它们指向的实际物理路径，这对于避免一些部署上的混淆很有帮助。