shutil 是 Python 中的高級文件操作模塊，與os模塊形成互補的關系，os主要提供了文件或文件夾的新建、刪除、查看等方法，還提供了對文件以及目錄的路徑操作。shutil模塊提供了移動、復制、 壓縮、解壓等操作，恰好與os互補，共同一起使用，基本能完成所有文件的操作。是一個非常重要的模塊。

[[340659]]

#加載包 
import shutil 
#查看包中的所有方法 
print(dir(shutil)) 
[ 'chown', 'collections', 'copy', 'copy2', 'copyfile', 'copyfileobj', 'copymode', 'copystat', 'copytree', 'disk_usage', 'errno', 'fnmatch', 'get_archive_formats', 'get_terminal_size', 'get_unpack_formats', 'getgrnam', 'getpwnam', 'ignore_patterns', 'make_archive', 'move', 'nt', 'os', 'register_archive_format', 'register_unpack_format', 'rmtree', 'stat', 'sys', 'unpack_archive', 'unregister_archive_format', 'unregister_unpack_format', 'which'] 

1. copy()

描述：復制文件

語法：shutil.copy(fsrc，path)，返回值：返回復制之后的路徑

• fsrc：源文件
• path：目標地址

shutil.copy('test.csv','C:/Users/zhengxiang.wzx/Desktop/') 
'C:/Users/zhengxiang.wzx/Desktop/test.csv' 

2. copy2()

描述：復制文件和狀態(tài)信息

語法：shutil.copy(fsrc，path)，返回值：返回復制之后的路徑

• fsrc：源文件
• path：目標地址

shutil.copy2('test.csv','C:/Users/zhengxiang.wzx/Desktop/') 
'C:/Users/zhengxiang.wzx/Desktop/test.csv' 

3. copyfileobj()

描述：將一個文件的內容拷貝到另一個文件中，如果目標文件本身就有內容，來源文件的內容會把目標文件的內容覆蓋掉。如果文件不存在它會自動創(chuàng)建一個。

語法：shutil.copyfileobj(fsrc, fdst[, length=16*1024])

• fsrc：源文件
• fdst：復制至fdst文件
• length：緩沖區(qū)大小，即fsrc每次讀取的長度

import shutil 
f1 = open('file.txt','r') 
f2 = open('file_copy.txt','w+') 
shutil.copyfileobj(f1,f2,length=16*1024) 

4. copyfile()

描述：將一個文件的內容拷貝到另一個文件中，目標文件無需存在

語法：shutil.copyfile(src, dst,follow_symlinks)

• src：源文件路徑
• dst：復制至dst文件，若dst文件不存在，將會生成一個dst文件;若存在將會被覆蓋
• follow_symlinks：設置為True時，若src為軟連接，則當成文件復制;如果設置為False，復制軟連接。默認為True。

#file_1不存在，會產生一個 
shutil.copyfile('file_0.csv','file_1.csv') 
'file_1.csv' 
 
#file_2存在，直接復制 
shutil.copyfile('file_0.csv','file_2.csv') 
'file_2.csv' 

5. copytree()

描述：復制整個目錄文件，不需要的文件類型可以不復制

語法：shutil.copytree(oripath, despath, ignore= shutil.ignore_patterns("*.xls", "*.doc"))

參數：

• oripath : "來源路徑"
• despath : "目標路徑"
• ignore : shutil.ignore_patterns() 是對內容進行忽略篩選，將對應的內容進行忽略。

import shutil,os 
path1 = os.path.join(os.getcwd(),"kaggle") 
path1 
'C:\\Users\\wuzhengxiang\\Desktop\\Python知識點總結\\kaggle' 
#bbb與ccc文件夾都可以不存在,會自動創(chuàng)建 
path2 = os.path.join(os.getcwd(),"bbb","ccc") 
path2 
'C:\\Users\\wuzhengxiang\\Desktop\\Python知識點總結\\bbb\\ccc' 
# 將"abc.txt","bcd.txt"忽略，不復制 
shutil.copytree(path1,path2,ignore=shutil.ignore_patterns("abc.txt","bcd.txt")) 

6. copymode()

描述：拷貝權限，前提是目標文件存在，不然會報錯。將src文件權限復制至dst文件。文件內容，所有者和組不受影響

語法：shutil.copymode(src，dst)

• src：源文件路徑
• dst：將權限復制至dst文件，dst路徑必須是真實的路徑，并且文件必須存在，否則將會報文件找不到錯誤
• follow_symlinks：設置為False時，src, dst皆為軟連接，可以復制軟連接權限，如果設置為True，則當成普通文件復制權限。默認為True。Python3新增參數

shutil.copymode("file_0.csv","file_1.csv") 

7. move()

描述：移動文件或文件夾

語法：shutil.move(src, dst)

os.chdir('C:/Users/wuzhengxiang/Desktop/Python知識點總結') 
os.getcwd() 
shutil.move('file_1.csv', 'C:/Users/wuzhengxiang/Desktop/股票數據分析') 
'C:/Users/wuzhengxiang/Desktop/股票數據分析\\file_1.csv' 

8. disk_usage()

描述：查看磁盤使用信息，計算磁盤總存儲，已用存儲，剩余存儲信息。

語法：shutil.disk_usage('盤符')

返回值：元組

shutil.disk_usage('D:') 
usage(total=151199412224, used=41293144064, free=109906268160) 
 
total，總存儲：151199412224/1024/1024/1024=140GB 
used，已使用：41293144064/1024/1024/1024=38GB 
free，剩余容量：109906268160/1024/1024/1024=102GB 

9.  make_archive()

描述：壓縮打包

語法：make_archive(base_name, format, root_dir=None, base_dir=None, verbose=0,dry_run=0, owner=None, group=None, logger=None)

壓縮打包：

• base_name： 壓縮包的文件名，也可以是壓縮包的路徑。只是文件名時，則保存至當前目錄，否則保存至指定路徑
• format： 壓縮或者打包格式 "zip", "tar", "bztar"or "gztar"
• root_dir : 將哪個目錄或者文件打包(也就是源文件)

#把當前目錄下的file_1.csv打包壓縮 
shutil.make_archive('file_1.csv','gztar',root_dir='C:/Users/wuzhengxiang/Desktop/股票數據分析') 
'C:\\Users\\wuzhengxiang\\Desktop\\股票數據分析\\file_1.csv.tar.gz' 

10. get_archive_formats()

描述： 獲取支持的壓縮文件格式。目前支持的有：tar、zip、gztar、bztar。在Python3還多支持一種格式xztar

語法：unpack_archive(filename, extract_dir=None, format=None)

• filename：文件路徑
• extract_dir：解壓至的文件夾路徑。文件夾可以不存在，會自動生成
• format：解壓格式，默認為None，會根據擴展名自動選擇解壓格式

import shutil,os 
zip_path = os.path.join(os.getcwd(),"file_1.csv.tar") 
extract_dir = os.path.join(os.getcwd(),"aaa") 
shutil.unpack_archive(zip_path, extract_dir) 

11. rmtree()

描述：遞歸的去刪除文件

語法：shutil.rmtree(path[, ignore_errors[, onerror]])

#刪除文件夾 
shutil.rmtree('C:/Users/wuzhengxiang/Desktop/Python知識點總結/test2')