封装通用函数,统一处理边界情况:
from pathlib import Path
def get_filename_robust(path):
"""鲁棒的文件名提取(处理空路径、尾部分隔符、相对路径)"""
try:
p = Path(path)
# 规范化路径(处理..、.等)
p = p.resolve() if p.is_absolute() else p.absolute()
return p.name if p.name else ""
except (ValueError, OSError):
# 路径无效时返回空
return ""
# 测试
print(get_filename_robust("/home/user/docs/")) # docs
print(get_filename_robust("")) # ""
print(get_filename_robust("C:\\path\\to\\file")) # file
优势:避免在业务代码中重复处理异常,提升可维护性。
跨平台测试方案(模拟不同系统路径):
import os
from pathlib import Path
def test_cross_platform():
test_cases = [
"/home/user/docs/report.pdf", # Unix
"C:\\Users\\admin\\report.pdf", # Windows
"relative/path/file.txt", # 相对路径
"data/", # 尾部分隔符
".", # 当前目录
]
for path in test_cases:
# 模拟不同系统分隔符
if os.sep == '\\':
path = path.replace('/', '\\')
else:
path = path.replace('\\', '/')
# 测试提取方法
p = Path(path)
print(f"路径: {path} → 文件名: {p.name}")
test_cross_platform()
建议:在CI/CD中同时测试Linux/Windows环境,确保路径逻辑无差异。
日志中记录路径提取结果(调试利器):
import logging
from pathlib import Path
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)
def process_file(path):
p = Path(path)
logger.info(f"处理文件: {path} → 基名: {p.stem}, 扩展: {p.suffix}")
# 业务逻辑...
return p.name
# 日志输出示例
# INFO:__main__:处理文件: /var/log/app.log → 基名: app, 扩展: .log
生产建议:在关键路径处理点增加日志,便于定位“路径解析错误”类问题。