Python pathlib模块:告别os.path的笨拙,拥抱现代路径操作!

from pathlib import Path# 方式1：从字符串直接创建p1 = Path("data/config.ini")  # 相对路径p2 = Path("/home/user/docs")  # 绝对路径（Unix）p3 = Path(r"C:\Windows\System32")  # 绝对路径（Windows）# 方式2：拼接创建（推荐！）config_path = Path("data") / "config" / "settings.ini"print(f"拼接路径: {config_path}")# 输出: data/config/settings.ini# 方式3：获取当前工作目录和脚本所在目录current_dir = Path.cwd()  # 当前工作目录script_dir = Path(__file__).parent.resolve()  # 脚本所在目录（重要！）print(f"脚本目录: {script_dir}")

# 创建一个示例路径p = Path("/home/user/docs/report.pdf")# 基础属性print(f"原始路径: {p}")              # /home/user/docs/report.pdfprint(f"父目录: {p.parent}")         # /home/user/docsprint(f"文件名（含后缀）: {p.name}")   # report.pdfprint(f"文件名（无后缀）: {p.stem}")   # reportprint(f"后缀名: {p.suffix}")         # .pdfprint(f"根目录: {p.root}")           # /# 多重后缀处理archive = Path("archive.tar.gz")print(f"后缀列表: {archive.suffixes}")  # ['.tar', '.gz']print(f"最后后缀: {archive.suffix}")    # .gz# 绝对路径与规范化relative = Path("data/../config/./settings.ini")abs_path = relative.resolve()  # 解析为绝对路径，并规范化print(f"规范化路径: {abs_path}")# 输出: /current/working/dir/config/settings.ini

# 创建测试路径test_file = Path("test.txt")test_dir = Path("test_dir")# 存在性检测print(f"文件存在: {test_file.exists()}")  # 检查文件或目录是否存在print(f"是否为文件: {test_file.is_file()}")  # 精确判断是否为文件print(f"是否为目录: {test_file.is_dir()}")   # 精确判断是否为目录# 高级检测print(f"是否为绝对路径: {test_file.is_absolute()}")print(f"是否为符号链接: {test_file.is_symlink()}")print(f"是否为挂载点: {test_file.is_mount()}")  # 检查是否为挂载点# 跨平台安全检测if test_file.exists() and test_file.is_file():# 安全操作文件    print("文件存在且是普通文件")

# 目录操作data_dir = Path("data")# 安全创建目录（自动处理父目录）data_dir.mkdir(exist_ok=True)  # 目录已存在时不报错data_dir.mkdir(parents=True, exist_ok=True)  # 同时创建父目录# 删除目录（需为空）data_dir.rmdir()# 遍历目录for item in data_dir.iterdir():if item.is_file():        print(f"文件: {item.name}")elif item.is_dir():        print(f"目录: {item.name}")# 文件操作config_file = data_dir / "config.json"# 写入文件（自动创建、自动关闭）config_file.write_text('{"key": "value"}', encoding="utf-8")# 读取文件（无需手动open）content = config_file.read_text(encoding="utf-8")print(f"文件内容: {content}")# 重命名/移动new_file = config_file.with_name("settings.json")config_file.rename(new_file)# 修改后缀txt_file = Path("document.txt")md_file = txt_file.with_suffix(".md")print(f"新文件: {md_file}")  # document.md

# 1. walk()方法：替代os.walk()for root, dirs, files in Path("project").walk():    print(f"目录: {root}")    print(f"子目录数: {len(dirs)}")    print(f"文件数: {len(files)}")# 2. case_sensitive参数：跨平台大小写处理# Windows上默认case_sensitive=False，Unix上为Truetxt_files = list(Path(".").glob("*.TXT", case_sensitive=False))# 3. 子类化支持：自定义Path类classProjectPath(Path):"""自定义项目路径类"""def__init__(self, *args):        super().__init__(*args)    @propertydefis_source_file(self):return self.suffix in ['.py', '.js', '.ts']# 使用自定义类src_file = ProjectPath("src/main.py")print(f"是否为源码文件: {src_file.is_source_file}")

# 创建路径对象project_root = Path("/home/user/project")source_file = project_root / "src" / "main.py"external_file = Path("/var/log/system.log")# 判断路径相对关系print(f"source_file相对于project_root: {source_file.is_relative_to(project_root)}")  # Trueprint(f"external_file相对于project_root: {external_file.is_relative_to(project_root)}")  # False# 安全路径操作：确保文件在项目目录内defsafe_read_file(root: Path, file_path: str) -> str:"""安全读取文件，防止目录遍历攻击"""    full_path = (root / file_path).resolve()ifnot full_path.is_relative_to(root.resolve()):raise ValueError(f"非法路径: {file_path}")return full_path.read_text()# 使用示例try:    content = safe_read_file(project_root, "config/settings.ini")    print("文件读取成功")except ValueError as e:    print(f"安全错误: {e}")

# 基础globpy_files = list(Path("src").glob("*.py"))print(f"Python文件数: {len(py_files)}")# 递归glob（rglob）all_py_files = list(Path(".").rglob("*.py"))print(f"所有Python文件: {len(all_py_files)}")# 复杂模式匹配log_files = list(Path("logs").glob("app-*.log"))data_files = list(Path("data").glob("202[4-5]-*.csv"))# 使用match方法进行模式测试patterns = ["*.py", "test_*.py", "*.txt"]test_file = Path("test_module.py")for pattern in patterns:    matches = test_file.match(pattern)print(f"'{test_file}' 匹配 '{pattern}': {matches}")

from pathlib import Pathimport jsonclassConfigManager:"""项目配置管理器"""def__init__(self, project_root=None):        self.project_root = Path(project_root or Path.cwd())        self.config_dir = self.project_root / "config"defget_config_path(self, env="development"):"""获取指定环境的配置文件路径"""        config_file = self.config_dir / f"{env}.json"# 安全检查：确保文件在项目目录内        config_file = config_file.resolve()ifnot config_file.is_relative_to(self.project_root.resolve()):raise ValueError("配置文件路径越界")return config_filedefload_config(self, env="development"):"""加载指定环境的配置"""        config_path = self.get_config_path(env)ifnot config_path.exists():# 创建默认配置            default_config = {"database": {"host": "localhost","port": 5432,"name": f"app_{env}"                },"logging": {"level": "INFO"if env == "production"else"DEBUG","file": f"logs/app_{env}.log"                }            }            config_path.parent.mkdir(exist_ok=True)            config_path.write_text(                json.dumps(default_config, indent=2),                encoding="utf-8"            )return default_config# 读取现有配置        content = config_path.read_text(encoding="utf-8")return json.loads(content)# 使用示例config_manager = ConfigManager()dev_config = config_manager.load_config("development")prod_config = config_manager.load_config("production")

from pathlib import Pathfrom datetime import datetime, timedeltaimport shutilclassLogRotator:"""日志轮转管理器"""def__init__(self, log_dir="logs", retention_days=30):        self.log_dir = Path(log_dir)        self.retention_days = retention_days        self.archive_dir = self.log_dir / "archive"defrotate_logs(self):"""执行日志轮转"""# 确保目录存在        self.log_dir.mkdir(exist_ok=True)        self.archive_dir.mkdir(exist_ok=True)# 获取当前时间        now = datetime.now()# 遍历日志文件for log_file in self.log_dir.glob("app_*.log"):ifnot log_file.is_file():continue# 获取文件修改时间            mtime = datetime.fromtimestamp(log_file.stat().st_mtime)            days_old = (now - mtime).days# 超过1天的日志进行归档if days_old >= 1:# 构建归档文件名                date_str = mtime.strftime("%Y%m%d")                new_name = f"{log_file.stem}_{date_str}{log_file.suffix}"                archive_path = self.archive_dir / new_name# 移动文件                log_file.rename(archive_path)                print(f"归档: {log_file.name} → {new_name}")# 清理过期归档        self.cleanup_old_archives()defcleanup_old_archives(self):"""清理超过保留期限的归档文件"""        cutoff_date = datetime.now() - timedelta(days=self.retention_days)for archive_file in self.archive_dir.glob("*.log"):            mtime = datetime.fromtimestamp(archive_file.stat().st_mtime)if mtime < cutoff_date:                archive_file.unlink()                print(f"删除过期归档: {archive_file.name}")# 使用示例rotator = LogRotator(retention_days=7)rotator.rotate_logs()

from pathlib import Pathfrom PIL import Imageimport osclassBatchFileProcessor:"""批量文件处理器"""def__init__(self, source_dir, target_dir):        self.source_dir = Path(source_dir)        self.target_dir = Path(target_dir)        self.target_dir.mkdir(parents=True, exist_ok=True)defconvert_images_format(self, from_ext=".jpg", to_ext=".webp", quality=80):"""批量转换图片格式"""        converted_count = 0for img_file in self.source_dir.rglob(f"*{from_ext}"):ifnot img_file.is_file():continuetry:# 构建目标路径                relative_path = img_file.relative_to(self.source_dir)                new_stem = relative_path.stem                target_file = self.target_dir / f"{new_stem}{to_ext}"# 转换图片with Image.open(img_file) as img:                    img.save(target_file, quality=quality)                converted_count += 1                print(f"转换: {img_file.name} → {target_file.name}")except Exception as e:                print(f"转换失败 {img_file}: {e}")return converted_countdefrename_files_with_prefix(self, prefix="backup_"):"""批量添加前缀重命名"""for file_path in self.source_dir.iterdir():if file_path.is_file():                new_name = f"{prefix}{file_path.name}"                new_path = file_path.with_name(new_name)                file_path.rename(new_path)                print(f"重命名: {file_path.name} → {new_name}")# 使用示例processor = BatchFileProcessor("images/original", "images/converted")converted = processor.convert_images_format(".png", ".webp", quality=85)print(f"成功转换 {converted} 张图片")

import timefrom pathlib import Pathimport osdefperformance_comparison():"""pathlib与os.path性能对比"""    test_count = 10000    test_path = __file__# 测试os.path    start = time.perf_counter()for _ in range(test_count):        dirname = os.path.dirname(test_path)        basename = os.path.basename(test_path)        exists = os.path.exists(test_path)    os_time = time.perf_counter() - start# 测试pathlib    start = time.perf_counter()    p = Path(test_path)for _ in range(test_count):        dirname = p.parent        basename = p.name        exists = p.exists()    pathlib_time = time.perf_counter() - start    print(f"os.path 耗时: {os_time:.4f}秒")    print(f"pathlib 耗时: {pathlib_time:.4f}秒")    print(f"性能差异: {(pathlib_time - os_time)/os_time*100:.2f}%")# 执行测试performance_comparison()

# 不推荐：每次循环都创建新对象for filename in file_list:    p = Path(filename)  # 每次循环都创建新Path对象if p.exists():        process(p)# 推荐：预创建Path对象或缓存path_objects = [Path(f) for f in file_list]for p in path_objects:if p.exists():        process(p)

# resolve()开销较大，避免不必要的调用p = Path("data/config.ini")# 需要时再调用if need_absolute:    abs_path = p.resolve()# 避免重复调用cached_resolved = p.resolve()

# 批量读取文件：使用生成器避免内存爆炸defread_files_batch(file_paths, batch_size=100):for i in range(0, len(file_paths), batch_size):        batch = file_paths[i:i+batch_size]for file_path in batch:yield file_path.read_text()# 批量写入：使用临时文件+原子移动import tempfiledefsafe_batch_write(target_dir, file_data):with tempfile.TemporaryDirectory() as tmp_dir:        tmp_path = Path(tmp_dir)for filename, content in file_data.items():            tmp_file = tmp_path / filename            tmp_file.write_text(content)# 原子移动for tmp_file in tmp_path.iterdir():            target_file = target_dir / tmp_file.name            tmp_file.replace(target_file)

# 旧代码import osconfig_path = os.path.join(os.path.dirname(__file__), "config", "settings.ini")if os.path.exists(config_path):with open(config_path) as f:        content = f.read()# 新代码（第一步：导入pathlib）import osfrom pathlib import Path# 逐步替换script_dir = Path(__file__).parentconfig_path = script_dir / "config" / "settings.ini"if config_path.exists():    content = config_path.read_text()

# 旧代码中的硬编码路径data_file = "C:\\Users\\name\\data\\input.csv"# 新代码：使用Path和跨平台处理from pathlib import Path# 方法1：使用用户目录home_dir = Path.home()data_file = home_dir / "data" / "input.csv"# 方法2：使用项目相对路径project_root = Path(__file__).parent.parentdata_file = project_root / "data" / "input.csv"

# os.path.join的特殊行为result = os.path.join("/home/user", "/tmp/file.txt")# 结果: '/tmp/file.txt'（前面的路径被丢弃）# pathlib的/运算符更合理result = Path("/home/user") / "/tmp/file.txt"# 结果: '/tmp/file.txt'（同样丢弃前面）# 最佳实践：确保使用相对路径safe_result = Path("/home/user") / "tmp" / "file.txt"

# 危险：混合类型导致错误p = Path("data/config.ini")if os.path.exists(p):  # 可能出错，老版本Python不支持    content = p.read_text()# 安全：统一使用Path方法if p.exists():    content = p.read_text()

# 问题：相对路径依赖当前工作目录p = Path("../config.ini")content = p.read_text()  # 依赖于os.getcwd()# 解决：明确基准目录base_dir = Path(__file__).parentabs_path = (base_dir / p).resolve()content = abs_path.read_text()

# 问题：Windows和Unix换行符不同content = p.read_text()  # 默认使用系统换行符# 解决：明确指定换行符content = p.read_text(newline="\n")  # 统一使用Unix换行符

import pandas as pdp = Path("data/data.csv")df = pd.read_csv(str(p))  # 转换为字符串

# UNC路径（Windows）unc_path = PureWindowsPath(r"\\server\share\file.txt")# 特殊设备可能需要使用os模块import osos.stat("/dev/null")