os.path.dirname

os.path.dirname() 是 Python 中 os.path 模块的一个函数，用于获取指定文件路径的目录部分（即去掉文件名后的路径）。以下是详细说明和用法示例：

函数原型

os.path.dirname(path)

关键特性

1. 提取目录部分：
   从完整路径中分离出目录部分（不包含文件名）。

2. 不检查路径是否存在：
   仅操作字符串，不验证路径是否真实存在。

3. 处理边界情况： • 如果输入是文件名（如 file.txt），返回空字符串 ''。 • 如果输入是根目录（如 / 或 C:\），返回根目录本身。

示例代码

import os

# 示例1：标准文件路径
path = "/home/user/documents/file.txt"
print(os.path.dirname(path))  # 输出: /home/user/documents

# 示例2：当前目录下的文件
path = "data/sample.csv"
print(os.path.dirname(path))  # 输出: data

# 示例3：只有文件名（无目录）
path = "file.txt"
print(os.path.dirname(path))  # 输出: （空字符串）

# 示例4：根目录
path = "/"
print(os.path.dirname(path))  # 输出: /

# 示例5：Windows路径
path = r"C:\Users\admin\notes.txt"
print(os.path.dirname(path))  # 输出: C:\Users\admin

常见用途

1. 动态获取脚本所在目录：

   import os
   script_dir = os.path.dirname(os.path.abspath(__file__))
   print("脚本目录:", script_dir)

2. 拼接路径（结合 os.path.join）：

   base_dir = os.path.dirname("/data/files/input.txt")
   new_path = os.path.join(base_dir, "output.txt")  # /data/files/output.txt

3. 规范化路径（结合 os.path.normpath）：

   path = "/home/user/../documents/./file.txt"
   normalized = os.path.normpath(path)  # /home/documents/file.txt
   dir_part = os.path.dirname(normalized)  # /home/documents

与 os.path.basename() 对比

• dirname() 返回目录部分，basename() 返回文件名部分：

path = "/home/user/file.txt"
print(os.path.dirname(path))  # /home/user
print(os.path.basename(path)) # file.txt

注意事项

• 如果路径以 / 结尾，dirname() 会忽略末尾的 /：

path = "/home/user/"
print(os.path.dirname(path))  # 输出: /home

from pathlib import Path
dir_part = Path("/home/user/file.txt").parent  # 等效于 dirname

通过 os.path.dirname()，可以轻松提取路径中的目录部分，适合文件路径的动态处理和分析。