【Python】os.path.splitext() 函数：分割文件名和扩展名

os.path.splitext() —— 分割文件名和扩展名

os.path.splitext() 是 Python os.path 模块中的一个函数，用于分割文件的主文件名和扩展名。

---

1. 语法

import os

os.path.splitext(path)

参数

• path：文件路径（可以是相对路径或绝对路径）。

返回值

• 返回一个 元组 (filename, extension)：
  • filename：主文件名（不包括扩展名）。
  • extension：文件扩展名（包括 . 号）。

---

2. 示例

2.1 分割文件名和扩展名

import os

file_path = "example.txt"
name, ext = os.path.splitext(file_path)

print(name)  # 输出: example
print(ext)   # 输出: .txt

---

2.2 适用于不同文件类型

import os

print(os.path.splitext("document.pdf"))   # ('document', '.pdf')
print(os.path.splitext("image.jpeg"))     # ('image', '.jpeg')
print(os.path.splitext("archive.tar.gz")) # ('archive.tar', '.gz')  ❗️
print(os.path.splitext("no_extension"))   # ('no_extension', '')  ❗️

注意

• splitext() 只会分离最后一个 . 后面的部分，即使文件有多个 .。
• .tar.gz 文件不会被识别为 .tar.gz，而是分割为 ('archive.tar', '.gz')。

---

2.3 结合 os.path.basename() 处理完整路径

如果你想 仅获取文件名和扩展名，可以先用 os.path.basename() 取出文件名：

import os

file_path = "/home/user/documents/report.docx"

# 获取完整文件名
file_name = os.path.basename(file_path)

# 分割文件名和扩展名
name, ext = os.path.splitext(file_name)

print(name)  # 输出: report
print(ext)   # 输出: .docx

---

3. 使用 pathlib.Path.suffix（推荐方式）

Python 3.4+ 推荐使用 pathlib 进行路径操作，替代 os.path。

from pathlib import Path

file_path = Path("archive.tar.gz")

print(file_path.stem)   # 'archive.tar' （去掉最后一个扩展名）
print(file_path.suffix) # '.gz' （最后一个扩展名）
print(file_path.suffixes) # ['.tar', '.gz'] （所有扩展名）

优点

• suffix 获取单个扩展名。
• suffixes 获取所有扩展名（.tar.gz 会识别为 ['.tar', '.gz']）。

---

4. splitext() vs pathlib

方法	适用版本	识别 .tar.gz	推荐使用
os.path.splitext()	适用于 Python 2 & 3	❌ 识别为 .gz	适用于简单路径
Path.suffix	Python 3.4+	❌ 识别为 .gz	适用于简单扩展名
Path.suffixes	Python 3.4+	✅ 识别为 ['.tar', '.gz']	推荐

---

5. 总结

✅ os.path.splitext() 适用于 简单文件扩展名分割。
✅ pathlib.Path 更推荐，支持 .suffix 和 .suffixes，更直观易用。