萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python 檔案讀寫完整教學:open()、with 語句、編碼處理、二進制模式與 file-like Object

檔案 I/O 是程式設計基礎。本文系統講解 Python 檔案操作:open() 模式參數、with 上下文管理器、文字/二進制模式、編碼轉換、codecs 模組、大檔案分塊讀取、file-like Object 介面概念,提供生產級最佳實踐。

核心 API:open()

f = open(file, mode='r', encoding=None, errors='strict', buffering=-1)

模式參數完整表

模式說明指標初始位置
r唯讀(預設)開頭
w寫入,截斷既有檔案開頭
a附加,不截斷結尾
r+讀寫開頭
w+讀寫,截斷開頭
a+讀寫,附加結尾
b二進制模式(搭配上述)-
t文字模式(預設)-

讀取檔案:with 語句(強烈推薦)

# 一次性讀取全部(小檔案)
with open('/path/to/file', 'r', encoding='utf-8') as f:
    content = f.read()

# 逐行讀取(大檔案、記憶體友善)
with open('/path/to/file', 'r', encoding='utf-8') as f:
    for line in f:
        process(line.strip())

# 指定大小分塊讀取
with open('/path/to/file', 'r') as f:
    while True:
        chunk = f.read(8192)
        if not chunk:
            break
        process(chunk)

# readlines() 返回列表(適合配置檔)
with open('config.ini') as f:
    for line in f.readlines():
        print(line.strip())

寫入檔案

# 文字模式
with open('/path/to/file', 'w', encoding='utf-8') as f:
    f.write('Hello, world!')
    f.writelines(['line1\n', 'line2\n'])

# 二進制模式(圖片、影片、序列化資料)
with open('/path/to/image.jpg', 'wb') as f:
    f.write(binary_data)

編碼處理:避免亂碼核心

# 錯誤示範:預設編碼依賴平台
with open('gbk.txt', 'r') as f:
    print(f.read())  # 可能亂碼

# 正確:明確指定編碼
with open('gbk.txt', 'r', encoding='gbk') as f:
    print(f.read())

# 二進制讀取 + 手動解碼
with open('gbk.txt', 'rb') as f:
    content = f.read().decode('gbk')

# codecs 模組:開啟時自動轉碼
import codecs
with codecs.open('gbk.txt', 'r', 'gbk') as f:
    print(f.read())  # 直接得到 unicode

file-like Object:鴨子型別介面

任何實作 read()/write() 的物件皆為 file-like:

  • StringIO / BytesIO:記憶體緩衝
  • gzip.GzipFile:壓縮檔透明讀寫
  • socket.makefile():網路流
  • tempfile.TemporaryFile:臨時檔
  • 自訂類別:實作 read(size) 即可

常見錯誤與最佳實踐

錯誤後果正確做法
忘記 close()資源洩漏、資料未刷新到磁碟永遠用 with
大檔案 read()記憶體爆炸 (OOM)分塊讀取或逐行迭代
隱含編碼跨平台亂碼明確 encoding='utf-8'
文字模式寫入二進制TypeError 或資料損壞用 wb 模式
追加模式未換行內容連在一起f.write('\n' + content)

進階:原子性寫入(避免部分寫入損壞)

import os, tempfile

def atomic_write(path, data, mode='w', encoding='utf-8'):
    dirname = os.path.dirname(path)
    with tempfile.NamedTemporaryFile(mode=mode, encoding=encoding, dir=dirname, delete=False) as tf:
        tf.write(data)
        tempname = tf.name
    os.rename(tempname, path)  # 原子性替換(POSIX 保證)
copyright © 萬盛學電腦網 all rights reserved