【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']`	推荐