Python 的 `os` 模块是操作系统交互接口，其 `os.rename()` 函数是进行文件重命名的核心方法，它能将一个现有文件或目录重命名为另一个新名称，本质上是修改其在文件系统中的路径记录[ref_2][ref_5]。 `os.rename()` 函数的基本语法如下： ```python os.rename(src, dst) ``` 其中，`src` 是源文件的路径（字符串），`dst` 是目标文件的新路径[ref_2]。此操作会直接修改文件系统中的条目，若目标文件已存在且操作系统允许，它将被覆盖；若源文件不存在或没有操作权限，则会引发 `FileNotFoundError` 或 `PermissionError` 等异常。 一个基本的使用示例如下[ref_2]： ```python import os # 假设当前目录下有一个名为 “old_name.txt” 的文件 old_name = "old_name.txt" new_name = "new_name.txt" # 检查源文件是否存在 if os.path.exists(old_name): os.rename(old_name, new_name) print(f"文件已成功从 “{old_name}” 重命名为 “{new_name}”") else: print(f"源文件 “{old_name}” 不存在，无法重命名。") ``` 针对不同的应用场景，需要采用不同的策略。以下是关键操作场景的对比与实现方法[ref_5]： | 场景 | 关键操作与函数 | 注意事项 | | :--- | :--- | :--- | | **1. 基本文件重命名** | `os.rename(src, dst)` | 确保 `src` 存在，且 `dst` 所在目录有写入权限[ref_2]。 | | **2. 跨目录移动并重命名** | `os.rename(src, dst)` 或 `shutil.move(src, dst)` | `os.rename` 通常不能跨磁盘驱动器操作，跨驱动器需使用 `shutil.move()`[ref_5]。 | | **3. 批量重命名文件** | 结合 `os.listdir()`、`os.path.join()` 和循环 | 需精确设计新文件名规则，并处理好路径拼接[ref_6]。 | | **4. 递归重命名目录及内容** | `os.renames(old, new)` | 类似 `os.rename()`，但会自动创建目标路径所需的所有中间目录，并在必要时删除空目录[ref_4]。 | | **5. 带异常处理的安全重命名** | `try...except` 块捕获 `OSError` | 增强程序鲁棒性，处理文件不存在、权限不足等情况。 | **场景一：跨目录移动并重命名** `os.rename()` 可以在同一文件系统内修改文件的绝对路径，从而实现移动和重命名的双重效果[ref_4]。 ```python import os # 将当前目录下的 ‘report.txt’ 移动到 ‘./archive/’ 目录下，并改名为 ‘2024_report_backup.txt’ src_file = "./report.txt" dst_file = "./archive/2024_report_backup.txt" # 确保目标目录存在，否则 os.rename 会报错 os.makedirs(os.path.dirname(dst_file), exist_ok=True) try: os.rename(src_file, dst_file) print(f"文件已移动并重命名为：{dst_file}") except FileNotFoundError: print("源文件未找到。") except PermissionError: print("权限不足，操作被拒绝。") ``` **场景二：批量重命名文件（添加前缀）** 这是自动化处理中常见需求，例如为一批图片文件添加统一前缀[ref_6]。 ```python import os folder_path = "./photos" prefix = "vacation_" # 列出目录下所有文件和子目录 for filename in os.listdir(folder_path): # 构造完整的源文件路径 src = os.path.join(folder_path, filename) # 仅处理文件，忽略子目录 (可根据需要调整) if os.path.isfile(src): # 构造新文件名：前缀 + 原文件名 new_filename = prefix + filename dst = os.path.join(folder_path, new_filename) # 执行重命名 os.rename(src, dst) print(f"已重命名：{filename} -> {new_filename}") ``` **场景三：递归重命名目录结构** `os.renames(old, new)` 函数功能更强大，它不仅重命名终端文件或目录，还会根据需要创建目标路径中所有缺失的父目录，并在重命名完成后，移除源路径中因此操作而变得空置的目录[ref_4]。这非常适用于整个目录树的迁移与重组。 ```python import os # 将 ‘project/draft/notes.txt’ 重命名为 ‘project/final/report.txt’ # 如果 ‘project/final’ 目录不存在，os.renames 会自动创建它。 # 如果 ‘project/draft’ 目录在移动 notes.txt 后变为空目录，它将被删除。 try: os.renames("project/draft/notes.txt", "project/final/report.txt") print("目录树重命名/移动完成。") except OSError as e: print(f"操作失败：{e}") ``` **场景四：带异常处理的健壮代码** 在生产环境中，必须考虑各种失败情况[ref_5]。 ```python import os def safe_rename(src, dst): """ 安全地重命名文件或目录。 """ try: os.rename(src, dst) return True, f"成功：'{src}' -> '{dst}'" except FileNotFoundError: return False, f"失败：源路径 ‘{src}’ 未找到。" except PermissionError: return False, f"失败：对 ‘{src}’ 或 ‘{dst}’ 权限不足。" except OSError as e: # 捕获其他可能的操作系统错误，如跨设备链接无效等 return False, f"失败：系统错误 - {e}" # 使用示例 success, message = safe_rename("data.log", "archive/data_old.log") print(message) ``` `os` 模块重命名操作的核心在于路径字符串的操作。正确使用 `os.path.join()` 来构建路径可以避免因操作系统不同（Windows 使用 `\`，Linux/macOS 使用 `/`）导致的路径错误[ref_1]。`os.path` 子模块还提供了 `exists()`, `isfile()`, `isdir()`, `basename()`, `dirname()` 等函数，在进行重命名操作前进行验证和路径解析非常有用[ref_1]。