本文介绍使用 Python pathlib.Path 优雅构建带 _new 后缀的新文件路径，避免手动拆分扩展名，提升代码可读性与健壮性。
本文介绍使用 python `pathlib.path` 优雅构建带 `_new` 后缀的新文件路径，避免手动拆分扩展名，提升代码可读性与健壮性。
在 Python 3.4+（尤其是 3.12.2）中，pathlib 已成为处理文件路径的推荐方式。相比传统 os.path 的字符串拼接，pathlib.Path 提供面向对象、语义清晰且跨平台安全的路径操作能力。
核心优势在于：Path.stem 自动提取不带扩展名的主文件名，Path.suffix 精确获取包括点号在内的扩展名（如 .txt、.py），Path.parent 返回父目录路径，而 / 运算符支持自然的路径拼接——这一切都无需手动调用 os.path.splitext() 或字符串切片，显著降低出错风险。
以下是一个简洁、可复用的函数示例：
from pathlib import Path
def make_new_name(filepath: Path, suffix: str = "_new") -> Path:
"""基于原文件路径生成新文件路径，格式为 'stem + suffix + suffix'"""
return filepath.parent / (filepath.stem + suffix + filepath.suffix)
# 使用示例
original = Path("/data/reports/summary.csv")
new_path = make_new_name(original, "_processed")
print(new_path) # 输出：/data/reports/summary_processed.csv
# 保存内容时直接使用
with open(new_path, "w", encoding="utf-8") as f:
f.write("Processed content here.")⚠️ 注意事项：
- 确保传入参数为 Path 对象（非字符串），否则 stem 和 suffix 属性不可用；可统一用 Path(file_str) 转换；
- filepath.suffix 始终包含前导点（.），因此无需额外添加，避免出现 file_new..txt 这类错误；
- 若原始文件无扩展名（如 README），filepath.suffix 将为空字符串 ""，结果仍符合预期（如 README_new）；
- Path.parent / ... 自动处理路径分隔符（Windows \ / Unix /），无需关心平台差异。
总结：摒弃 os.path.splitext() 的脆弱字符串操作，拥抱 pathlib 是现代 Python 文件路径处理的最佳实践。它让命名逻辑更直观、更可靠，也使代码更具可维护性和可测试性。
