shelve 是 Python 標準庫提供的簡易持久化模組,底層以 dbm (或 gdbm/ndbm) 為儲存後端,將 Python 物件透過 pickle 序列化後以鍵值對形式存入磁碟。它的 API 與 dict 高度一致,適合儲存中小型結構化資料,無需架設資料庫伺服器。
import shelve
# 開啟/建立資料庫(預設儲存為數個檔案:.dat, .dir, .bak)
with shelve.open('mydata') as db:
# 寫入
db['user:1001'] = {'name': 'Alice', 'age': 30, 'tags': ['vip', 'beta']}
db['config'] = {'theme': 'dark', 'lang': 'zh-TW'}
# 讀取
print(db['user:1001']) # {'name': 'Alice', 'age': 30, ...}
print(db.get('nonexist', 'N/A')) # 安全取值
# 更新(注意:必須整個取出、修改、再存回)
user = db['user:1001']
user['age'] = 31
db['user:1001'] = user # 必須重新指派才會持久化
# 刪除
del db['config']
# 遍歷
for k in db:
print(k, '->', db[k])
# 預設 writeback=False,修改可變物件(list/dict)需手動回寫
# 若開啟 writeback=True,會在記憶體快取所有讀取物件,關閉時一次寫入
with shelve.open('mydata', writeback=True) as db:
db['user:1001']['tags'].append('premium') # 直接修改生效
# 注意:大量資料時會佔用較多記憶體,關閉較慢
shelve 不支援多執行緒/多程序並發寫入。若有並發需求,請自行加鎖(threading.Lock 或 fcntl.flock),或改用 SQLite / Redis。
pickle 序列化的物件(自訂類別需定義 __reduce__ 或使用 __getstate__/__setstate__)。#!/usr/bin/env python3
import shelve, sys, cmd
class MemoShell(cmd.Cmd):
prompt = 'memo> '
intro = '簡易備忘錄 (help 顯示指令)'
def __init__(self, dbpath='memo.db'):
super().__init__()
self.dbpath = dbpath
def _db(self):
return shelve.open(self.dbpath, writeback=True)
def do_add(self, arg):
'新增: add '
try:
k, v = arg.split(maxsplit=1)
except ValueError:
print('用法: add key value')
return
with self._db() as db:
db[k] = v
print(f'已儲存 {k}')
def do_get(self, key):
'讀取: get '
with self._db() as db:
print(db.get(key, '找不到'))
def do_list(self, _):
'列出所有鍵'
with self._db() as db:
for k, v in db.items():
print(f'{k}: {v}')
def do_del(self, key):
'刪除: del '
with self._db() as db:
if key in db:
del db[key]
print('已刪除')
else:
print('不存在')
def do_quit(self, _):
'離開'
return True
if __name__ == '__main__':
MemoShell().cmdloop()
| 方案 | 適用場景 | 優點 | 缺點 |
|---|---|---|---|
shelve | 單機、小資料量、無結構查詢 | 零配置、API 簡單、標準庫 | 無並發、無索引、大資料效能差 |
sqlite3 | 結構化資料、需 SQL 查詢、輕量並發 | 標準 SQL、ACID、單一檔案 | 需定義 Schema、序列化需自行處理 |
json/yaml 檔案 | 設定檔、人工可讀、版控友善 | 純文字、跨語言、Git diff 友善 | 整檔讀寫、無索引、大檔案慢 |
redis | 高效能、分散式、快取、發布訂閱 | 極快、資料結構豐富、支援叢集 | 需額外伺服器、資料易失性(除非開啟 AOF/RDB) |
shelve 最省事。sqlite3。redis 或資料庫。with shelve.open(...) as db: 確保正確關閉同步。writeback=True 下長時間持有大量快取物件。