shutil.move详解

Python中的shutil库提供了一组高级文件操作接口，其中shutil.move()函数是其中之一。它可以将一个文件或文件夹移动到另一个路径，并重命名该文件或文件夹。

一、shutil.move函数

shutil.move()函数具有以下形式：

shutil.move(src, dst, copy_function=copy2) 

其中，src是想要移动的文件夹或文件名（包括路径），dst是目标路径，而copy_function是一个可选参数，它定义了如何复制文件。默认的复制方法是copy2方法，该方法将保留所有文件元数据。

二、shutil.move把文件弄不见了

当使用shutil.move()函数时，需要注意以下几点：

1、如果目标路径中已经存在同名的文件或文件夹，则会覆盖它。

2、如果源文件不存在，将会抛出一个错误。

3、如果目标路径是一个文件夹，则shutil.move()会将源文件移动到该文件夹中，并使用源文件的名称进行重命名。

下面的代码演示了一个将文件移动到指定目录的实例：

import shutil
    
shutil.move('C:/Users/PycharmProjects/test/test.txt', 'C:/Users/PycharmProjects/result.txt')

上面的代码将’C:/Users/PycharmProjects/test/test.txt’文件移动到’C:/Users/PycharmProjects/’目录下，并重命名为result.txt。

三、shutil.move 覆盖

如前所述，如果目标路径已经存在同名的文件或文件夹，则shutil.move()将覆盖它。

为了避免该问题，可以在使用shutil.move()之前检查目标路径是否存在。下面的代码演示了这一点：

import shutil
import os
    
if os.path.exists('C:/Users/PycharmProjects/result.txt'):
    os.remove('C:/Users/PycharmProjects/result.txt')
shutil.move('C:/Users/PycharmProjects/test/test.txt', 'C:/Users/PycharmProjects/result.txt')

代码中，首先使用os.path.exists()检查目标路径C:/Users/PycharmProjects/result.txt是否存在，如果存在则删除该文件。然后再使用shutil.move()将源文件移动到目标路径。

四、shutil.move的用法

shutil.move()函数有以下用法：

1、移动文件夹到指定的目录并更改名称。

shutil.move('C:/Users/PycharmProjects/test_folder', 'C:/Users/PycharmProjects/folder_new_name')

上面的代码将’C:/Users/PycharmProjects/test_folder’文件夹移动到’C:/Users/PycharmProjects’目录下，并将其重命名为’folder_new_name’。

2、移动文件到指定的目录并更改名称。

shutil.move('C:/Users/PycharmProjects/test/test.txt', 'C:/Users/PycharmProjects/result.txt')

上面的代码将’C:/Users/PycharmProjects/test/test.txt’文件移动到’C:/Users/PycharmProjects’目录下，并将其重命名为’result.txt’。

3、移动文件到指定目录并强制覆盖目标文件。

shutil.move('C:/Users/PycharmProjects/test_folder', 'C:/Users/PycharmProjects/folder_new_name', copy_function=shutil.copy)

上面的代码将’C:/Users/PycharmProjects/test_folder’文件夹移动到’C:/Users/PycharmProjects’目录下，并强制覆盖’C:/Users/PycharmProjects/folder_new_name’文件夹。

五、shutil.move 重命名

shutil.move()函数可以重命名一个文件，只需将文件的路径设置为新名称即可。下面的代码演示了这个功能：

shutil.move('C:/Users/PycharmProjects/result.txt', 'C:/Users/PycharmProjects/new_name.txt')

上面的代码将’C:/Users/PycharmProjects/result.txt’重命名为’C:/Users/PycharmProjects/new_name.txt’。

六、shutil.move函数报错

当源文件不存在或目标文件已经存在时，shutil.move()函数会抛出错误。可以使用try/except语句来处理异常，并确保程序正常运行。下面的代码演示了这一点：

import shutil
import os
    
try:
    shutil.move('C:/Users/PycharmProjects/test_folder', 'C:/Users/PycharmProjects/folder_new_name')
except Exception as e:
    print('An error occurred: {}'.format(e))
    
if os.path.exists('C:/Users/PycharmProjects/folder_new_name'):
    print('Folder renamed successfully.')

代码中，首先尝试使用shutil.move()函数重命名’C:/Users/PycharmProjects/test_folder’为’C:/Users/PycharmProjects/folder_new_name’，如果出现错误则在控制台打印异常信息。然后使用os.path.exists()来检查’C:/Users/PycharmProjects/folder_new_name’是否存在，如果存在则输出相应信息，若不存在则不输出。

七、shutil.move 覆盖文件

如前所述，使用shutil.move()函数移动文件时，如果目标路径已经存在同名的文件，则shutil.move()将覆盖它。为了避免数据丢失，可以在移动之前先备份目标文件。下面的代码演示了这一点：

import shutil
import os
    
if os.path.exists('C:/Users/PycharmProjects/result.txt'):
    shutil.copyfile('C:/Users/PycharmProjects/result.txt', 'C:/Users/PycharmProjects/result_backup.txt')
shutil.move('C:/Users/PycharmProjects/test/test.txt', 'C:/Users/PycharmProjects/result.txt')

代码中，首先使用os.path.exists()检查目标路径C:/Users/PycharmProjects/result.txt是否存在，如果存在则使用shutil.copyfile()函数备份该文件。然后再使用shutil.move()将源文件移动到目标路径。

结论

在Python编程中，shutil.move()函数是一个非常有用的工具，可以帮助我们轻松地移动和重命名文件和文件夹。我们可以使用该函数的多个变体来实现不同的场景，但在使用时需要注意一些问题，如源文件是否存在、目标路径是否已经存在同名的文件等等。掌握shutil.move()的使用方法，可以让我们更好地处理文件操作，提高编程效率。