shutil 用法

copyfile()

copyfile()函数用于将一个文件的内容复制到另一个文件之中，准备的来说，它不是copy内容，而是直接copy文件，并重命名。

示例如下：

1 2 3

import shutil shutil.copyfile('week.csv', 'week_copy.csv')

copy2()

不过，copyfile()函数用于复制文件有一个缺陷，该函数的原理是通过打开源文件进行读取。所以，如果是某些特殊的文件，比如是UNIX设备节点，没有权限会报IOERROR错误。

还需要注意的是，通过copyfile()函数复制的文件是一个新文件，它不包括旧文件的访问时间与修改时间。

而copy2()函数可以复制文件后保留访问时间，修改时间。示例如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17

import shutil import os import time shutil.copy2('week.csv', 'week_copy.csv') stat_info1 = os.stat('week.csv') stat_info2 = os.stat('week_copy.csv') print("源文件信息") print(oct(stat_info1.st_mode)) print('文件创建时间:{}'.format(time.ctime(stat_info1.st_ctime))) print('文件访问时间:{}'.format(time.ctime(stat_info1.st_atime))) print('文件修改时间:{}'.format(time.ctime(stat_info1.st_mtime))) print("复制文件信息") print(oct(stat_info2.st_mode)) print('文件创建时间:{}'.format(time.ctime(stat_info2.st_ctime))) print('文件访问时间:{}'.format(time.ctime(stat_info2.st_atime))) print('文件修改时间:{}'.format(time.ctime(stat_info2.st_mtime)))

copymode()与copystat()

通过copy2()函数，我们知道了如何复制文件内容和文件信息等操作。但是其复制并不包含文件的权限，比如我们的Win10系统C盘中，有些文件只能读不能写，那么如果将权限也复制过去呢？

答案是：copymode()函数，示例如下：

1 2 3 4 5 6 7 8 9

import shutil import os, stat with open("temp.txt", 'wt') as file:     file.write("11111111111111111") os.chmod("temp.txt", stat.S_IREAD) shutil.copymode('temp_copymode.txt', 'temp.txt') print(oct(os.stat('temp.txt').st_mode)) print(oct(os.stat('temp_copymode.txt').st_mode))

需要注意的是，copymode()复制的只是文件权限，不是文件，也就是被赋予权限的文件名必须存在后才能将某个文件的权限复制给它。比如这里temp_copymode.txt获取temp.txt权限，那么temp_copymode.txt必须存在后才能操作。而且这只是复制权限，并没有复制内容。（stat.S_IXGRP组用户组执行权限）

至于copystat()函数，不仅复制权限，而且也复制了文件的信息。具体代码如下：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20

import shutil import os, stat import time with open("temp.txt", 'wt') as file:     file.write("11111111111111111") os.chmod("temp.txt", stat.S_IXGRP) shutil.copystat('temp_copymode.txt', 'temp.txt') stat_info1 = os.stat('temp.txt') stat_info2 = os.stat('temp_copymode.txt') print("源文件信息") print(oct(stat_info1.st_mode)) print('文件创建时间:{}'.format(time.ctime(stat_info1.st_ctime))) print('文件访问时间:{}'.format(time.ctime(stat_info1.st_atime))) print('文件修改时间:{}'.format(time.ctime(stat_info1.st_mtime))) print("复制文件信息") print(oct(stat_info2.st_mode)) print('文件创建时间:{}'.format(time.ctime(stat_info2.st_ctime))) print('文件访问时间:{}'.format(time.ctime(stat_info2.st_atime))) print('文件修改时间:{}'.format(time.ctime(stat_info2.st_mtime)))

copytree()复制整个文件夹

上面的所有复制都是针对单个文件的操作，但其实我们还会在实际的项目中，将整个文件夹复制到另一个位置。而且复制整个文件夹肯定会用到递归，不过shutil库有一个更简单的函数用于实现该操作：copytree()。

示例如下：

1 2 3

import shutil shutil.copytree('./text', './text_copy')

这里一行代码就可以完成整个文件夹的实现。需要注意的是，第2个参数为需要复制到的目录，但该文件夹不能存在，copytree()函数会自动创建的，如果存在会报错。

参数copy_function

有时候，我们复制文件夹并不是需要将整个文件夹都复制过来，而是只需要指定的符合规则的文件，比如我们只需要某个文件夹下的所有后缀为py的文件，那么怎么筛选呢？

示例如下：

1 2 3 4 5 6 7

import shutil def verbose_copy(src, dst):     if src.endswith(".py"):         return shutil.copy2(src, dst) shutil.copytree('./text', './text_copy', copy_function=verbose_copy)

这里，我们通过copytree()函数的参数copy_function进行参数，该参数提供一个函数用于筛选符合规则的文件进行复制，比如这里，我们提供了一个函数，并判断后缀是否是.py然后再创建，当然，它会保存目录结构，但只复制.py后缀的文件。

参数ignore

copytree()不仅只有copy_function参数，还有一个ignore参数，它可以过滤掉某些文件，比如还是如上面一样，但是我们不需要.py后缀的文件，其他文件都复制，那么可以这样实现。

1 2 3

import shutil shutil.copytree('./text', './text_copy', ignore=shutil.ignore_patterns('*.py'))

这样，就不会复制*.py规则的文件。

rmtree()删除整个文件夹

1 2 3

import shutil shutil.rmtree('./text_copy')

查找文件

在更多的文件操作中，我们往往还需要查找某个文件。而shutil库提供了which()函数用于搜索查找目标文件。它有3个参数：mode可以设置查找文件的权限，path为需要查找的路径，cmd为要查找的文件。

示例如下：

1 2 3 4

import shutil filename = shutil.which('python') print(filename)

get_archive_formats()归档

shutil库提供了更多高层函数来创建和解压归档文件。我们先来看看shutil库支持哪些格式，示例如下：

1 2 3 4

import shutil for format,desc in shutil.get_archive_formats():     print('{:<5}:{}'.format(format,desc))

make_archive()压缩文件

我们先来看一个简单的例子，将某个文件夹进行压缩，代码如下：

1 2 3

import shutil shutil.make_archive('text','gztar',root_dir='..',base_dir='base_demo')

unpack_archive()解压缩

既然有压缩，肯定也就有解压缩。shutil库提供了unpack_archive()进行解压缩文件。示例如下：

1 2 3

import shutil shutil.unpack_archive('text.tar.gz',extract_dir='text_un')

unpack_archive()函数的第1个参数为需要解压的文件，第2个参数为需要解压到哪里。

disk_usage()文件系统空间

完成一个长时间运行的可能耗尽可用空间的操作之前，最好先检查本地文件系统，来看看有多少可用的空间。shutil库提供了disk_usage()函数来返回包括总空间，当前正在使用的空间以及未使用的空间。

示例如下：

1 2 3 4 5 6 7

import shutil (total, used, free) = shutil.disk_usage("E:/") BytesPerGB = 1024 * 1024 * 1024 print ("Total: %.2fGB" % (float(total)/BytesPerGB)) print ("Used: %.2fGB" % (float(used)/BytesPerGB)) print ("Free: %.2fGB" % (float(free)/BytesPerGB))

来源：https://www.jb51.net/article/211773.htm

https://www.mihaoyun.com