shutil

shutil模块提供了许多关于文件和文件集合的高级操作，特别提供了支持文件复制和删除的功能。(将文件内容拷贝到另一个文件中)

copyfileobj(fsrc, fdst, length=16*1024)： 将fsrc文件内容复制至fdst文件，length为fsrc每次读取的长度，用做缓冲区大小

• fsrc： 源文件
• fdst： 复制至fdst文件
• length： 缓冲区大小，即fsrc每次读取的长度

shutil.copyfileobj(open('bbb.txt', 'r', encoding='utf-8'), open('new_bbb.txt', 'w', encoding='utf-8'))

copyfile(src, dst)： 将src文件内容复制至dst文件(拷贝文件)

• src： 源文件路径
• dst： 复制至dst文件，若dst文件不存在，将会生成一个dst文件；若存在将会被覆盖
• follow_symlinks：设置为True时，若src为软连接，则当成文件复制；如果设置为False，复制软连接。默认为True。Python3新增参数

shutil.copyfile('bbb.txt', 'new_66.txt')

copymode(src, dst)： 将src文件权限复制至dst文件。文件内容，所有者和组不受影响(仅拷贝权限。内容、组、用户均不变)

• src： 源文件路径
• dst： 将权限复制至dst文件，dst路径必须是真实的路径，并且文件必须存在，否则将会报文件找不到错误
• follow_symlinks：设置为False时，src, dst皆为软连接，可以复制软连接权限，如果设置为True，则当成普通文件复制权限。默认为True。Python3新增参数

shutil.copymode('bbb.txt', 'new_66.txt')

copystat(src, dst)： 将权限，上次访问时间，上次修改时间以及src的标志复制到dst。文件内容，所有者和组不受影响(仅拷贝状态的信息，包括：mode bits, atime, mtime, flags)

• src： 源文件路径
• dst： 将权限复制至dst文件，dst路径必须是真实的路径，并且文件必须存在，否则将会报文件找不到错误
• follow_symlinks：设置为False时，src, dst皆为软连接，可以复制软连接权限、上次访问时间，上次修改时间以及src的标志，如果设置为True，则当成普通文件复制权限。默认为True。Python3新增参数

shutil.copystat('bbb.txt', 'new_66.txt')

copy(src, dst)： 将文件src复制至dst。dst可以是个目录，会在该目录下创建与src同名的文件，若该目录下存在同名文件，将会报错提示已经存在同名文件。权限会被一并复制。本质是先后调用了copyfile与copymode而已.(拷贝文件和权限)

• src：源文件路径
• dst：复制至dst文件夹或文件
• follow_symlinks：设置为False时，src, dst皆为软连接，可以复制软连接权限，如果设置为True，则当成普通文件复制权限。默认为True。Python3新增参数

shutil.copy('bbb.txt', 'new_66.txt')

copy2(src, dst)： 将文件src复制至dst。dst可以是个目录，会在该目录下创建与src同名的文件，若该目录下存在同名文件，将会报错提示已经存在同名文件。权限、上次访问时间、上次修改时间和src的标志会一并复制至dst。本质是先后调用了copyfile与copystat方法而已.(拷贝文件和状态信息)

• src：源文件路径
• dst：复制至dst文件夹或文件
• follow_symlinks：设置为False时，src, dst皆为软连接，可以复制软连接权限、上次访问时间，上次修改时间以及src的标志，如果设置为True，则当成普通文件复制权限。默认为True。Python3新增参数

improt shutil
import os
shutil.copy2("file.txt","file_copy.txt")
# 或者
shutil.copy2("file.txt",os.path.join(os.getcwd(),"copy"))

ignore_patterns(*patterns)： 忽略模式，用于配合copytree()方法，传递文件将会被忽略，不会被拷贝

• patterns：文件名称，元组

copytree(src, dst, symlinks=False, ignore=None)： 拷贝文档树，将src文件夹里的所有内容拷贝至dst文件夹(递归的去拷贝文件夹)

• src：源文件夹
• dst：复制至dst文件夹，该文件夹会自动创建，需保证此文件夹不存在，否则将报错
• symlinks：是否复制软连接，True复制软连接，False不复制，软连接会被当成文件复制过来，默认False
• ignore：忽略模式，可传入ignore_patterns()
• copy_function：拷贝文件的方式，可以传入一个可执行的处理函数，默认为copy2，Python3新增参数
• ignore_dangling_symlinks：sysmlinks设置为False时，拷贝指向文件已删除的软连接时，将会报错，如果想消除这个异常，可以设置此值为True。默认为False,Python3新增参数

folder1 = r'E:\python\test'
folder2 = r'E:\python\tes\cc'
shutil.copytree(folder1, folder2,ignore=shutil.ignore_patterns('index.py))
# ,ignore=shutil.ignore_patterns('index.py) 传递文件将会被忽略，不会被拷贝

rmtree(path, ignore_errors=False, onerror=None)： 移除文档树，将文件夹目录删除

• ignore_errors：是否忽略错误，默认False
• onerror：定义错误处理函数，需传递一个可执行的处理函数，该处理函数接收三个参数：函数、路径和excinfo

folder1 = r'E:\python\tes\cc'
shutil.rmtree('folder1')

move(src, dst)： 将src移动至dst目录下。若dst目录不存在，则效果等同于src改名为dst。若dst目录存在，将会把src文件夹的所有内容移动至该目录下面

• src：源文件夹或文件
• dst：移动至dst文件夹，或将文件改名为dst文件。如果src为文件夹，而dst为文件将会报错
• copy_function：拷贝文件的方式，可以传入一个可执行的处理函数。默认为copy2，Python3新增参数

folder = r'E:\python\test\f'
fp = r'E:\python\test\c'
shutil.move(folder, fp)

disk_usage(path)： 获取当前目录所在硬盘使用情况。Python3新增方法

• path：文件夹或文件路径。windows中必须是文件夹路径，在linux中可以是文件路径和文件夹路径

fp = r'E:\pyhton\test'
info_date = shutil.disk_usage(fp)
print(info_date)

chown(path, user=None, group=None)： 修改路径指向的文件或文件夹的所有者或分组。Python3新增方法

• path：路径
• user：所有者，传递user的值必须是真实的，否则将报错no such user
• group：分组，传递group的值必须是真实的，否则将报错no such group

which(cmd, mode=os.F_OK | os.X_OK, path=None)： 获取给定的cmd命令的可执行文件的路径。Python3新增方法

info = shutil.which('python')
print(info)

shutil还提供了创建和读取压缩和存档文件的高级使用程序。内部实现主要依靠的是zipfile和tarfile模块

make_archive(base_name, format, root_dir, …)： 生成压缩文件

• base_name：压缩文件的文件名，不允许有扩展名，因为会根据压缩格式生成相应的扩展名(压缩包的文件名，也可以是压缩包的路径。只是文件名时，则保存至当前目录，否则保存至指定路径)
• format：压缩格式。压缩包种类，“zip”, “tar”, “bztar”，“gztar”
• root_dir：要压缩的文件夹路径（默认当前目录）
• owner： 用户，默认当前用户
• group： 组，默认当前组
• logger： 用于记录日志，通常是logging.Logger对象

shutil.unpack_archive('gcc.zip','E:\tpython\test\c','zip')

get_archive_formats()： 获取支持的压缩文件格式。目前支持的有：tar、zip、gztar、bztar。

('bztar', "bzip2'ed tar-file")
('gztar', "gzip'ed tar-file")
('tar', 'uncompressed tar file')
('xztar', "xz'ed tar-file")
('zip', 'ZIP file')

 

unpack_archive(filename, extract_dir=None, format=None)： 解压操作。Python3新增方法

• filename：文件路径
• extract_dir：解压至的文件夹路径。文件夹可以不存在，会自动生成
• format：解压格式，默认为None，会根据扩展名自动选择解压格式

shutil.unpack_archive('gcc.zip','E:\pyhton\test','zip')

get_unpack_formats()： 获取支持的解压文件格式。目前支持的有：tar、zip、gztar、bztar和xztar。Python3新增方法

 

import zipfile
# 压缩
z = zipfile.ZipFile('laxi.zip', 'w')
z.write('bb.text')  # 要压缩的文件或文件夹
z.write('c.txt')
z.close()

# 解压
z = zipfile.ZipFile('laxi.zip', 'r')
z.extractall(path='.')
z.close()