Python文件移动案例如何迁移文件

wen python案例 2026-07-01 198

本文目录导读：

Python文件移动案例如何迁移文件

基本文件移动方法
完整案例：批量文件迁移
按文件类型分类迁移
带进度显示的文件移动
文件移动工具类
使用建议

我来给你介绍几种Python文件移动的方法和案例。

基本文件移动方法

使用 shutil.move() - 最常用方法

import shutil
import os
# 移动单个文件
source_file = 'source.txt'
target_dir = 'target_folder/'
shutil.move(source_file, target_dir)
# 移动并重命名
shutil.move('old_name.txt', 'new_folder/new_name.txt')

使用 os.rename() - 简单移动

import os
# 在同一磁盘下移动
os.rename('source.txt', 'destination.txt')
# 跨目录移动（仅在同一个文件系统）
os.rename('folder1/file.txt', 'folder2/file.txt')

完整案例：批量文件迁移

import shutil
import os
from pathlib import Path
import glob
def move_files_with_pattern(source_dir, target_dir, pattern='*.*'):
    """
    按文件模式批量移动文件
    参数:
        source_dir: 源目录
        target_dir: 目标目录
        pattern: 文件匹配模式，如 '*.txt', '*.jpg'
    """
    # 确保目标目录存在
    Path(target_dir).mkdir(parents=True, exist_ok=True)
    # 查找匹配的文件
    files = glob.glob(os.path.join(source_dir, pattern))
    moved_count = 0
    for file_path in files:
        try:
            # 构建目标路径
            file_name = os.path.basename(file_path)
            target_path = os.path.join(target_dir, file_name)
            # 移动文件
            shutil.move(file_path, target_path)
            print(f"已移动: {file_path} -> {target_path}")
            moved_count += 1
        except Exception as e:
            print(f"移动失败 {file_path}: {e}")
    print(f"\n共成功移动 {moved_count} 个文件")
    return moved_count
# 使用方法
source = './downloads'
target = './archived_files'
move_files_with_pattern(source, target, '*.pdf')

按文件类型分类迁移

import shutil
import os
from pathlib import Path
def organize_files_by_extension(source_dir, target_base_dir):
    """
    按文件扩展名分类移动到不同文件夹
    """
    # 文件类型分类
    file_categories = {
        'documents': ['.pdf', '.doc', '.docx', '.txt'],
        'images': ['.jpg', '.jpeg', '.png', '.gif', '.bmp'],
        'videos': ['.mp4', '.avi', '.mkv', '.mov'],
        'music': ['.mp3', '.wav', '.flac', '.aac'],
        'archives': ['.zip', '.rar', '.tar', '.gz'],
    }
    # 创建目标目录
    for category in file_categories:
        Path(os.path.join(target_base_dir, category)).mkdir(parents=True, exist_ok=True)
    # 处理文件
    for file_name in os.listdir(source_dir):
        file_path = os.path.join(source_dir, file_name)
        if os.path.isfile(file_path):
            # 获取文件扩展名
            ext = os.path.splitext(file_name)[1].lower()
            # 查找对应的分类
            target_folder = None
            for category, extensions in file_categories.items():
                if ext in extensions:
                    target_folder = category
                    break
            # 如果没找到分类，放到其他
            if not target_folder:
                target_folder = 'others'
                Path(os.path.join(target_base_dir, 'others')).mkdir(exist_ok=True)
            # 移动文件
            target_path = os.path.join(target_base_dir, target_folder, file_name)
            # 处理同名文件
            counter = 1
            while os.path.exists(target_path):
                name, extension = os.path.splitext(file_name)
                target_path = os.path.join(target_base_dir, target_folder, f"{name}_{counter}{extension}")
                counter += 1
            shutil.move(file_path, target_path)
            print(f"已移动 {file_name} -> {target_folder}/")
# 使用示例
organize_files_by_extension('./downloads', './organized_files')

带进度显示的文件移动

import shutil
import os
from pathlib import Path
import time
def move_files_with_progress(source_dir, target_dir, file_pattern='*.*'):
    """
    移动文件并显示进度
    """
    source_path = Path(source_dir)
    target_path = Path(target_dir)
    # 获取所有要移动的文件
    files_to_move = list(source_path.glob(file_pattern))
    total_files = len(files_to_move)
    if total_files == 0:
        print("没有找到匹配的文件")
        return
    print(f"发现 {total_files} 个文件需要移动")
    # 创建目标目录
    target_path.mkdir(parents=True, exist_ok=True)
    for i, file in enumerate(files_to_move, 1):
        if file.is_file():
            try:
                # 显示进度
                percent = (i / total_files) * 100
                print(f"\r进度: [{i}/{total_files}] {percent:.1f}% - 正在移动: {file.name}", end='')
                # 移动文件
                dest = target_path / file.name
                # 处理重名文件
                if dest.exists():
                    name = file.stem
                    ext = file.suffix
                    counter = 1
                    while dest.exists():
                        dest = target_path / f"{name}_{counter}{ext}"
                        counter += 1
                shutil.move(str(file), str(dest))
                time.sleep(0.1)  # 模拟进度显示
            except Exception as e:
                print(f"\n移动失败 {file.name}: {e}")
    print(f"\n完成！共移动 {total_files} 个文件")
# 使用示例
move_files_with_progress('./temp', './archive', '*.txt')

文件移动工具类

import shutil
import os
from pathlib import Path
from typing import List, Optional
class FileMover:
    """文件移动工具类"""
    def __init__(self, source_dir: str, target_dir: str):
        self.source_dir = Path(source_dir)
        self.target_dir = Path(target_dir)
        self.moved_count = 0
        self.error_count = 0
    def move_single_file(self, filename: str, 
                         new_name: Optional[str] = None) -> bool:
        """移动单个文件"""
        source = self.source_dir / filename
        target = self.target_dir / (new_name or filename)
        try:
            self._ensure_target_dir()
            source.rename(target) if source.parent == self.source_dir else shutil.move(str(source), str(target))
            self.moved_count += 1
            return True
        except Exception as e:
            print(f"移动失败 {filename}: {e}")
            self.error_count += 1
            return False
    def move_by_pattern(self, pattern: str) -> int:
        """按模式移动文件"""
        self._ensure_target_dir()
        for file in self.source_dir.glob(pattern):
            if file.is_file():
                self.move_single_file(file.name)
        return self.moved_count
    def move_all(self, exclude: List[str] = None) -> int:
        """移动所有文件"""
        exclude = exclude or []
        self._ensure_target_dir()
        for file in self.source_dir.iterdir():
            if file.is_file() and file.name not in exclude:
                self.move_single_file(file.name)
        return self.moved_count
    def _ensure_target_dir(self):
        """确保目标目录存在"""
        self.target_dir.mkdir(parents=True, exist_ok=True)
    def get_status(self) -> dict:
        """获取移动状态"""
        return {
            'moved': self.moved_count,
            'errors': self.error_count,
            'source': str(self.source_dir),
            'target': str(self.target_dir)
        }
# 使用示例
# mover = FileMover('./source', './target')
# mover.move_by_pattern('*.py')
# mover.move_all(exclude=['important.txt', 'config.json'])
# print(mover.get_status())