在 Python 中，复制一个文件到指定文件夹有多种可靠方式。以下是**最常用、最健壮、跨平台（Windows/macOS/Linux）且支持中文路径的 4 种方法**，按推荐顺序排列，并附带完整可运行代码、错误处理和使用说明： --- ### ✅ 方法 1：`shutil.copy2()` —— **推荐首选（保留元数据 + 简单安全）** ```python import shutil import os def copy_file_to_folder(src_file: str, dst_folder: str) -> bool: """ 将文件复制到目标文件夹（自动创建目标文件夹，保留时间戳/权限） Args: src_file: 源文件绝对或相对路径（支持中文） dst_folder: 目标文件夹路径（支持中文，若不存在则自动创建） Returns: bool: 成功返回 True，失败打印错误并返回 False """ try: # 1. 检查源文件是否存在且为文件 if not os.path.isfile(src_file): print(f"❌ 错误：源文件不存在或不是文件 → '{src_file}'") return False # 2. 确保目标文件夹存在（递归创建） os.makedirs(dst_folder, exist_ok=True) # 3. 构造目标完整路径（保持原文件名） filename = os.path.basename(src_file) dst_path = os.path.join(dst_folder, filename) # 4. 复制（copy2 保留修改时间、访问时间、权限等元数据） shutil.copy2(src_file, dst_path) print(f"✅ 已复制：\n 源 → {os.path.abspath(src_file)}\n 目标 → {os.path.abspath(dst_path)}") return True except PermissionError: print(f"❌ 权限错误：无权读取源文件或写入目标文件夹 → '{src_file}' → '{dst_folder}'") except OSError as e: print(f"❌ 系统错误：{e}") except Exception as e: print(f"❌ 未知错误：{type(e).__name__}: {e}") return False # ✅ 使用示例（直接运行测试）： if __name__ == "__main__": # 替换为你自己的路径（支持中文！） source = r"C:\Users\liuqianhui\Downloads\test.txt" # 示例：源文件 destination_folder = r"C:\Users\liuqianhui\Desktop\备份文件夹" # 示例：目标文件夹 copy_file_to_folder(source, destination_folder) ``` > ✅ 优势： > - `shutil.copy2()` 保留 `mtime`（修改时间）、`atime`（访问时间）、文件权限（Linux/macOS）； > - `os.makedirs(..., exist_ok=True)` 自动创建多层不存在的目录（如 `a/b/c`）； > - 全面异常捕获，提示清晰； > - 完全兼容中文路径（Python 3.6+ 默认 UTF-8）。 --- ### ✅ 方法 2：`shutil.copy()` —— 简化版（不保留时间戳） ```python import shutil import os def copy_file_simple(src: str, dst_dir: str) -> None: dst = os.path.join(dst_dir, os.path.basename(src)) os.makedirs(dst_dir, exist_ok=True) shutil.copy(src, dst) # 不保留 atime/mtime print(f"📎 已复制：{src} → {dst}") # 调用示例： # copy_file_simple(r"D:\a.pdf", r"E:\我的文档\临时") ``` > ⚠️ 注意：`shutil.copy()` 只保留文件权限（mode），**不保留时间戳**；日常简单复制够用。 --- ### ✅ 方法 3：使用 `pathlib`（现代 Python 风格，更简洁） ```python from pathlib import Path import shutil def copy_with_pathlib(src: str, dst_dir: str) -> bool: src_path = Path(src) dst_path = Path(dst_dir) / src_path.name # 自动拼接目标路径 try: dst_path.parent.mkdir(parents=True, exist_ok=True) shutil.copy2(src_path, dst_path) print(f"📁 已复制：{src_path} → {dst_path}") return True except Exception as e: print(f"❌ 复制失败：{e}") return False # 示例： # copy_with_pathlib("report.xlsx", "D:/output/") ``` > ✅ 优点：路径操作更直观、链式调用、类型安全（`Path` 对象）。 --- ### ✅ 方法 4：命令行调用（仅 Windows，适合大文件或需后台静默） ```python import subprocess import os def copy_via_cmd(src: str, dst_dir: str) -> bool: """使用 Windows 'copy' 命令（速度快，但无 Python 异常控制）""" if not os.path.isfile(src): print("源文件不存在") return False os.makedirs(dst_dir, exist_ok=True) dst = os.path.join(dst_dir, os.path.basename(src)) result = subprocess.run( ['copy', '/Y', src, dst], shell=True, capture_output=True, text=True, encoding='utf-8' ) if result.returncode == 0: print(f"⚡ CMD 复制成功：{src} → {dst}") return True else: print("CMD 复制失败：", result.stderr) return False ``` > ⚠️ 仅限 Windows；`/Y` 跳过覆盖确认；适合超大文件（利用系统缓存）。 --- ### 🧩 补充：批量复制多个文件 ```python from pathlib import Path import shutil def copy_multiple_files(file_list: list, dst_folder: str): dst = Path(dst_folder) dst.mkdir(parents=True, exist_ok=True) for src in file_list: src_path = Path(src) if src_path.is_file(): shutil.copy2(src_path, dst / src_path.name) print(f"✓ {src_path.name}") else: print(f"⚠ 跳过非文件：{src}") # 示例： # copy_multiple_files( # [r"C:\a.txt", r"D:\b.jpg", r"E:\c.pdf"], # r"F:\汇总" # ) ``` --- ### ✅ 最佳实践建议 | 场景 | 推荐方法 | |------|----------| | ✅ 日常开发、脚本、需保留时间戳 | `shutil.copy2()`（方法1） | | ✅ 快速原型、不关心元数据 | `shutil.copy()`（方法2） | | ✅ Python 3.6+、喜欢面向对象路径操作 | `pathlib` + `shutil.copy2()`（方法3） | | ✅ Windows 下复制 >1GB 文件、追求极致速度 | `copy /Y`（方法4） | | ❌ 绝对不要用 | `os.system("copy ...")`（不安全、难调试、编码乱） | --- ### 🔍 常见错误与修复 | 错误现象 | 原因 | 解决 | |----------|------|------| | `FileNotFoundError: [Errno 2] No such file or directory` | 源路径错/目标父目录不存在 | 用 `os.path.isfile()` 和 `os.makedirs(..., exist_ok=True)` 预检 | | `PermissionError: [WinError 5] 拒绝访问` | 目标文件被占用/只读/权限不足 | 关闭目标文件，或用管理员运行；检查 `os.access(dst_dir, os.W_OK)` | | 中文路径显示为 `????` | Python 控制台编码非 UTF-8（CMD 默认 GBK） | 在脚本开头加 `import io; io.TextIOWrapper.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8')`，或改用 PowerShell 运行 | ---