建離線個人財務(wù)助手)
本地個人財務(wù)助手可以做到完全離線運行你的賬單、預(yù)算、分類統(tǒng)計都保存在自己電腦上不依賴云端服務(wù)也不用擔心第三方讀取數(shù)據(jù)。本文將從需求拆解開始帶你實現(xiàn)一個基于 Python 和 SQLite 的本地個人財務(wù)助手包含收入支出記賬、分類統(tǒng)計、月度報表、預(yù)算提醒和 CSV 導(dǎo)入導(dǎo)出等功能。內(nèi)容覆蓋數(shù)據(jù)庫設(shè)計、命令行交互、數(shù)據(jù)校驗和常見報錯排查適合有一定 Python 基礎(chǔ)、想動手做工具類項目的開發(fā)者。1. 什么是本地個人財務(wù)助手1.1 從記賬需求說起很多人都有記賬的想法但堅持下來的并不多。市面上大多數(shù)記賬 App 都依賴云端同步雖然方便但存在幾個問題數(shù)據(jù)不在自己手里、訂閱費用不低、功能過于復(fù)雜、廣告和社區(qū)內(nèi)容干擾體驗。本地個人財務(wù)助手解決的就是這類痛點。它把數(shù)據(jù)保存在本地文件中例如 SQLite 數(shù)據(jù)庫所有增刪改查操作都在本機完成。用戶通過命令行、終端界面或者一個簡單的 Web 頁面與程序交互沒有網(wǎng)絡(luò)請求沒有用戶畫像也不需要注冊賬號。從開發(fā)角度看這類項目非常適合用來練習 Python 的文件處理、數(shù)據(jù)庫操作、異常捕獲和面向?qū)ο笤O(shè)計。它不像電商系統(tǒng)那樣龐大但已經(jīng)具備了一個完整業(yè)務(wù)系統(tǒng)的核心鏈路輸入校驗、數(shù)據(jù)存儲、統(tǒng)計匯總、報表輸出。1.2 本地財務(wù)助手與云端記賬軟件的區(qū)別對比維度本地財務(wù)助手云端記賬軟件數(shù)據(jù)存儲本地 SQLite / CSV云端服務(wù)器網(wǎng)絡(luò)依賴無必須聯(lián)網(wǎng)數(shù)據(jù)隱私完全本地隱私性強依賴服務(wù)商安全策略自定義能力高代碼即需求受產(chǎn)品功能限制多端同步不支持或需自行實現(xiàn)原生支持成本免費訂閱制或內(nèi)購如果你的數(shù)據(jù)敏感度比較高或者只是想通過一個小項目學習編程本地方案是更好的選擇。1.3 本文技術(shù)方案概覽本文選用的技術(shù)棧非常簡單Python 3.10SQLite3Python 標準庫自帶argparse 或 input() 交互prettytable 或直接格式化輸出pandas可選用于報表導(dǎo)出最終實現(xiàn)的效果是在終端運行python finance.py后進入交互菜單可以記賬、查賬、統(tǒng)計、設(shè)置預(yù)算、導(dǎo)入導(dǎo)出 CSV。項目結(jié)構(gòu)清晰代碼量控制在 600 行到 800 行之間適合閱讀和維護。2. 環(huán)境準備與項目結(jié)構(gòu)2.1 準備開發(fā)環(huán)境本文示例代碼基于 Python 3.10 編寫SQLite3 是 Python 標準庫不需要額外安裝。如果你的系統(tǒng)還沒有 Python建議先安裝 Python 3.10 或更高版本。檢查 Python 版本python --version在部分 Linux 系統(tǒng)中可能需要使用python3命令。確認版本沒問題后創(chuàng)建一個新的項目目錄mkdir finance-assistant cd finance-assistant建議在項目中使用虛擬環(huán)境避免污染全局 Python 包。當然由于本項目只依賴標準庫不創(chuàng)建虛擬環(huán)境也能正常運行。如果你想后續(xù)加入pandas或prettytable最好先創(chuàng)建虛擬環(huán)境。python -m venv venv source venv/bin/activate # Linux / macOS venv\Scripts\activate # Windows2.2 項目文件結(jié)構(gòu)推薦采用如下結(jié)構(gòu)finance-assistant/ ├── finance.py # 主程序入口交互菜單 ├── database.py # 數(shù)據(jù)庫連接和初始化 ├── models.py # 數(shù)據(jù)模型與校驗函數(shù) ├── reports.py # 報表統(tǒng)計 ├── utils.py # 工具函數(shù)如日期驗證、格式化 ├── data/ │ └── finance.db # SQLite 數(shù)據(jù)庫文件自動生成 └── requirements.txt # 依賴文件可無當然如果你希望快速上手也可以把所有代碼寫進一個文件。本文為了講解清晰按職責拆分模塊這樣更接近真實項目的組織方式。2.3 初始化 SQLite 數(shù)據(jù)庫SQLite 是一種嵌入式關(guān)系型數(shù)據(jù)庫不需要獨立服務(wù)進程數(shù)據(jù)保存在單個.db文件中。Python 內(nèi)置了sqlite3模塊可以直接操作。在database.py中創(chuàng)建數(shù)據(jù)庫連接并建表# database.py import sqlite3 import os DB_PATH os.path.join(os.path.dirname(__file__), data, finance.db) def get_connection(): os.makedirs(os.path.dirname(DB_PATH), exist_okTrue) conn sqlite3.connect(DB_PATH) conn.row_factory sqlite3.Row return conn def init_db(): conn get_connection() cursor conn.cursor() cursor.execute( CREATE TABLE IF NOT EXISTS transactions ( id INTEGER PRIMARY KEY AUTOINCREMENT, type TEXT NOT NULL CHECK(type IN (income, expense)), category TEXT NOT NULL, amount REAL NOT NULL, date TEXT NOT NULL, note TEXT DEFAULT ) ) cursor.execute( CREATE TABLE IF NOT EXISTS budget ( category TEXT PRIMARY KEY, limit_amount REAL NOT NULL ) ) conn.commit() conn.close()這里有兩個核心表transactions存儲每一筆收入或支出記錄包含類型、分類、金額、日期、備注。budget存儲每個分類的預(yù)算上限用于超支提醒。字段設(shè)計很簡潔但已經(jīng)能覆蓋常見個人記賬場景。如果后續(xù)要擴展家庭成員、賬戶、標簽等功能可以在此基礎(chǔ)上加表或加字段。3. 核心功能設(shè)計與代碼實現(xiàn)3.1 數(shù)據(jù)模型與輸入校驗在models.py中定義分類常量、數(shù)據(jù)校驗函數(shù)。分類不建議完全自由輸入否則統(tǒng)計時會很混亂。我們預(yù)置一份默認分類# models.py INCOME_CATEGORIES [工資, 獎金, 理財, 兼職, 其他收入] EXPENSE_CATEGORIES [餐飲, 交通, 購物, 居住, 娛樂, 醫(yī)療, 教育, 其他支出] VALID_TYPES (income, expense) def validate_amount(amount_str): try: amount float(amount_str) if amount 0: raise ValueError(金額必須大于 0) if amount 100000000: raise ValueError(金額超出合理范圍) return round(amount, 2) except ValueError as e: raise ValueError(f金額無效{e}) def validate_date(date_str): from datetime import datetime try: datetime.strptime(date_str, %Y-%m-%d) return date_str except ValueError: raise ValueError(日期格式應(yīng)為 YYYY-MM-DD例如 2025-01-15)這里有幾個設(shè)計考慮金額使用REAL類型存儲雖然存在浮點精度問題但個人記賬金額精度要求不高。如果要求精確計算可以使用整數(shù)分存儲或者用DECIMAL。金額必須大于 0且不能超過一個較大閾值避免誤輸入。日期統(tǒng)一使用字符串YYYY-MM-DD方便比較和排序。3.2 數(shù)據(jù)庫操作封裝在database.py中繼續(xù)添加增刪查函數(shù)def add_transaction(txn_type, category, amount, date, note): conn get_connection() cursor conn.cursor() cursor.execute( INSERT INTO transactions (type, category, amount, date, note) VALUES (?, ?, ?, ?, ?) , (txn_type, category, amount, date, note)) conn.commit() conn.close() def get_transactions(start_dateNone, end_dateNone, txn_typeNone): conn get_connection() cursor conn.cursor() sql SELECT * FROM transactions WHERE 11 params [] if start_date: sql AND date ? params.append(start_date) if end_date: sql AND date ? params.append(end_date) if txn_type: sql AND type ? params.append(txn_type) sql ORDER BY date DESC, id DESC cursor.execute(sql, params) rows cursor.fetchall() conn.close() return [dict(row) for row in rows] def delete_transaction(txn_id): conn get_connection() cursor conn.cursor() cursor.execute(DELETE FROM transactions WHERE id ?, (txn_id,)) conn.commit() deleted cursor.rowcount conn.close() return deleted 0使用參數(shù)化查詢的?占位符而不是直接拼接字符串這是為了防止 SQL 注入。即使這是本地單機應(yīng)用也應(yīng)該養(yǎng)成良好習慣。3.3 交互菜單設(shè)計主程序finance.py使用input()循環(huán)顯示菜單。為了讓輸出更清晰寫一個show_menu函數(shù)# finance.py from database import init_db, add_transaction, get_transactions, delete_transaction from models import ( INCOME_CATEGORIES, EXPENSE_CATEGORIES, validate_amount, validate_date, ) def main(): init_db() while True: print( 本地個人財務(wù)助手 1. 記一筆收入 2. 記一筆支出 3. 查看流水 4. 月度統(tǒng)計 5. 設(shè)置/查看預(yù)算 6. 刪除記錄 7. 導(dǎo)出 CSV 8. 退出 ) choice input(請輸入選項).strip() if choice 1: handle_income() elif choice 2: handle_expense() elif choice 3: handle_query() # ... 其他分支 elif choice 8: print(再見) break else: print(無效選項請重新輸入)每個處理函數(shù)都要做好異常捕獲避免因為用戶輸入不合法導(dǎo)致程序崩潰。例如收入錄入函數(shù)def handle_income(): print(收入分類 、.join(INCOME_CATEGORIES)) category input(請輸入收入分類).strip() if category not in INCOME_CATEGORIES: print(分類不合法) return try: amount validate_amount(input(請輸入金額).strip()) date validate_date(input(請輸入日期YYYY-MM-DD直接回車使用今天).strip() or today()) note input(請輸入備注).strip() add_transaction(income, category, amount, date, note) print(收入記錄已添加) except ValueError as e: print(f輸入錯誤{e})這種寫法有兩個好處每一類輸入都有獨立驗證任何一步出錯都只提示錯誤不會中斷主循環(huán)。3.4 報表統(tǒng)計實現(xiàn)報表是財務(wù)助手最實用的功能。我們需要實現(xiàn)按月份匯總收入、支出、結(jié)余。按分類匯總支出占比。預(yù)算超支提醒。在reports.py中編寫def monthly_summary(year_month): year_month 格式2025-01 conn get_connection() cursor conn.cursor() cursor.execute( SELECT type, SUM(amount) as total FROM transactions WHERE substr(date, 1, 7) ? GROUP BY type , (year_month,)) rows cursor.fetchall() result {income: 0, expense: 0} for row in rows: result[row[type]] round(row[total], 2) result[balance] round(result[income] - result[expense], 2) conn.close() return result def category_expense(year_month): conn get_connection() cursor conn.cursor() cursor.execute( SELECT category, SUM(amount) as total FROM transactions WHERE type expense AND substr(date, 1, 7) ? GROUP BY category ORDER BY total DESC , (year_month,)) rows cursor.fetchall() conn.close() return [dict(row) for row in rows]substr(date, 1, 7)是 SQLite 截取字符串前 7 位的函數(shù)正好對應(yīng)YYYY-MM。這種方法簡單高效不需要額外的時間函數(shù)。預(yù)算提醒邏輯def check_budget(year_month): budget_rows get_all_budget() expense_rows category_expense(year_month) alerts [] for b in budget_rows: spent 0 for e in expense_rows: if e[category] b[category]: spent e[total] break if spent b[limit_amount]: alerts.append(f{b[category]} 已超支預(yù)算 {b[limit_amount]}已用 {spent}) elif spent b[limit_amount] * 0.8: alerts.append(f{b[category]} 即將超支預(yù)算剩余不足 20%) return alerts“已用超過 80%”的提醒非常實用相當于把預(yù)算管理前置而不是等超支了才知道。4. 完整實戰(zhàn)案例下面我們從一個“新用戶”的視角把整個項目完整實現(xiàn)并跑通。這里采用單文件版本方便復(fù)制測試如果你想拆成多個模塊思路完全一樣。4.1 安裝依賴本項目單獨運行只需要標準庫不用安裝任何第三方包。如果你希望表格輸出更美觀可以安裝prettytablepip install prettytable但在完整代碼中為了零依賴運行我們手動格式化輸出避免安裝步驟。4.2 完整代碼下面是一個完整的finance.py文件通過注釋說明每一部分的功能。# finance.py import sqlite3 import os from datetime import datetime import csv DB_PATH os.path.join(os.path.dirname(__file__), data, finance.db) INCOME_CATEGORIES [工資, 獎金, 理財, 兼職, 其他收入] EXPENSE_CATEGORIES [餐飲, 交通, 購物, 居住, 娛樂, 醫(yī)療, 教育, 其他支出] def get_conn(): os.makedirs(os.path.dirname(DB_PATH), exist_okTrue) conn sqlite3.connect(DB_PATH) conn.row_factory sqlite3.Row return conn def init_db(): conn get_conn() conn.executescript( CREATE TABLE IF NOT EXISTS transactions ( id INTEGER PRIMARY KEY AUTOINCREMENT, type TEXT NOT NULL CHECK(type IN (income, expense)), category TEXT NOT NULL, amount REAL NOT NULL, date TEXT NOT NULL, note TEXT DEFAULT ); CREATE TABLE IF NOT EXISTS budget ( category TEXT PRIMARY KEY, limit_amount REAL NOT NULL ); ) conn.commit() conn.close() def validate_amount(value): try: amount float(value) if amount 0: raise ValueError(金額必須大于0) return round(amount, 2) except ValueError as e: raise ValueError(金額必須是有效數(shù)字) from e def validate_date(value): try: datetime.strptime(value, %Y-%m-%d) return value except ValueError: raise ValueError(日期格式必須為 YYYY-MM-DD) def today_str(): return datetime.now().strftime(%Y-%m-%d) def add_record(txn_type, category, amount, date, note): conn get_conn() conn.execute( INSERT INTO transactions (type, category, amount, date, note) VALUES (?, ?, ?, ?, ?), (txn_type, category, amount, date, note), ) conn.commit() conn.close() def query_records(monthNone, txn_typeNone): conn get_conn() sql SELECT * FROM transactions WHERE 11 params [] if month: sql AND substr(date, 1, 7) ? params.append(month) if txn_type: sql AND type ? params.append(txn_type) sql ORDER BY date DESC, id DESC rows conn.execute(sql, params).fetchall() conn.close() return [dict(r) for r in rows] def delete_record(record_id): conn get_conn() cur conn.execute(DELETE FROM transactions WHERE id ?, (record_id,)) conn.commit() conn.close() return cur.rowcount 0 def set_budget(category, limit_amount): conn get_conn() conn.execute( INSERT INTO budget (category, limit_amount) VALUES (?, ?) ON CONFLICT(category) DO UPDATE SET limit_amount excluded.limit_amount, (category, limit_amount), ) conn.commit() conn.close() def get_budgets(): conn get_conn() rows conn.execute(SELECT * FROM budget).fetchall() conn.close() return [dict(r) for r in rows] def monthly_summary(month): conn get_conn() rows conn.execute( SELECT type, SUM(amount) AS total FROM transactions WHERE substr(date, 1, 7) ? GROUP BY type, (month,), ).fetchall() conn.close() result {income: 0, expense: 0} for r in rows: result[r[type]] round(r[total], 2) result[balance] round(result[income] - result[expense], 2) return result def category_expense(month): conn get_conn() rows conn.execute( SELECT category, SUM(amount) AS total FROM transactions WHERE type expense AND substr(date, 1, 7) ? GROUP BY category ORDER BY total DESC, (month,), ).fetchall() conn.close() return [dict(r) for r in rows] def budget_alerts(month): budgets get_budgets() expenses category_expense(month) alert_list [] for b in budgets: spent 0 for e in expenses: if e[category] b[category]: spent e[total] break if spent b[limit_amount]: alert_list.append(f[超支] {b[category]} 預(yù)算 {b[limit_amount]}已支出 {spent}) elif b[limit_amount] 0 and spent b[limit_amount] * 0.8: alert_list.append(f[提醒] {b[category]} 已使用預(yù)算的 {spent/b[limit_amount]*100:.1f}%) return alert_list def export_csv(filepath): conn get_conn() rows conn.execute(SELECT * FROM transactions ORDER BY date).fetchall() conn.close() with open(filepath, w, newline, encodingutf-8-sig) as f: writer csv.writer(f) writer.writerow([ID, 類型, 分類, 金額, 日期, 備注]) for r in rows: type_cn 收入 if r[type] income else 支出 writer.writerow([r[id], type_cn, r[category], r[amount], r[date], r[note]]) return len(rows) def input_income(): print(可選分類 、.join(INCOME_CATEGORIES)) category input(收入分類).strip() if category not in INCOME_CATEGORIES: print(輸入錯誤分類不在可選列表中) return try: amount validate_amount(input(金額).strip()) date input(日期(YYYY-MM-DD直接回車用今天)).strip() or today_str() date validate_date(date) note input(備注).strip() add_record(income, category, amount, date, note) print(? 收入記錄已保存) except ValueError as e: print(f輸入錯誤{e}) def input_expense(): print(可選分類 、.join(EXPENSE_CATEGORIES)) category input(支出分類).strip() if category not in EXPENSE_CATEGORIES: print(輸入錯誤分類不在可選列表中) return try: amount validate_amount(input(金額).strip()) date input(日期(YYYY-MM-DD直接回車用今天)).strip() or today_str() date validate_date(date) note input(備注).strip() add_record(expense, category, amount, date, note) print(? 支出記錄已保存) except ValueError as e: print(f輸入錯誤{e}) def show_query(): month input(請輸入月份(YYYY-MM直接回車查全部)).strip() rows query_records(monthmonth) if month else query_records() if not rows: print(暫無記錄) return print(f{ID:5}{類型:6}{分類:10}{金額:12}{日期:12}{備注}) print(- * 60) for r in rows: type_cn 收入 if r[type] income else 支出 print(f{r[id]:5}{type_cn:6}{r[category]:10}{r[amount]:12}{r[date]:12}{r[note]}) total_income sum(r[amount] for r in rows if r[type] income) total_expense sum(r[amount] for r in rows if r[type] expense) print(- * 60) print(f當前篩選結(jié)果總收入 {total_income:.2f}總支出 {total_expense:.2f}) def show_monthly_report(): month input(請輸入月份(YYYY-MM)).strip() if not month: print(月份不能為空) return summary monthly_summary(month) print(f\n {month} 月度匯總 ) print(f收入{summary[income]:.2f}) print(f支出{summary[expense]:.2f}) print(f結(jié)余{summary[balance]:.2f}) print(\n支出分類明細) exp_rows category_expense(month) if not exp_rows: print(該月暫無支出) else: total_exp summary[expense] for e in exp_rows: percent e[total] / total_exp * 100 if total_exp else 0 print(f{e[category]}{e[total]:.2f}{percent:.1f}%) alerts budget_alerts(month) if alerts: print(\n預(yù)算提醒) for a in alerts: print(a) else: print(\n本月預(yù)算執(zhí)行良好) def main(): init_db() print(歡迎使用本地個人財務(wù)助手) while True: print( 主菜單 1. 記一筆收入 2. 記一筆支出 3. 查看流水 4. 月度統(tǒng)計 5. 設(shè)置預(yù)算 6. 查看預(yù)算 7. 刪除記錄 8. 導(dǎo)出 CSV 9. 退出 ) choice input(請輸入選項).strip() if choice 1: input_income() elif choice 2: input_expense() elif choice 3: show_query() elif choice 4: show_monthly_report() elif choice 5: try: cat input(輸入支出分類).strip() if cat not in EXPENSE_CATEGORIES: print(分類不合法) continue amt validate_amount(input(輸入預(yù)算金額).strip()) set_budget(cat, amt) print(預(yù)算已設(shè)置) except ValueError as e: print(f輸入錯誤{e}) elif choice 6: budgets get_budgets() if not budgets: print(還沒有設(shè)置預(yù)算) else: for b in budgets: print(f{b[category]}{b[limit_amount]:.2f}) elif choice 7: try: rid int(input(輸入要刪除的記錄 ID).strip()) if delete_record(rid): print(記錄已刪除) else: print(沒有找到該記錄) except ValueError: print(ID 必須是數(shù)字) elif choice 8: path input(輸入導(dǎo)出文件路徑默認 export.csv).strip() or export.csv try: count export_csv(path) print(f已導(dǎo)出 {count} 條記錄到 {path}) except Exception as e: print(f導(dǎo)出失敗{e}) elif choice 9: print(再見祝財務(wù)健康) break else: print(無效選項請重新輸入) if __name__ __main__: main()這段代碼可以直接保存為finance.py后運行。注意data目錄會自動創(chuàng)建不需要手動建。4.3 運行演示在項目目錄下執(zhí)行python finance.py首次運行會自動創(chuàng)建data/finance.db以及兩張表。接著演示一下完整操作流程。操作一記一筆收入1. 記一筆收入 可選分類工資、獎金、理財、兼職、其他收入 收入分類工資 金額15000 日期(YYYY-MM-DD直接回車用今天) 備注1月工資 ? 收入記錄已保存操作二記幾筆支出2. 記一筆支出 可選分類餐飲、交通、購物、居住、娛樂、醫(yī)療、教育、其他支出 支出分類餐飲 金額35.5 日期(YYYY-MM-DD直接回車用今天) 備注午餐 ? 支出記錄已保存再記錄一筆交通和一筆購物支出分類交通 金額200 備注地鐵卡充值支出分類購物 金額599 備注機械鍵盤操作三查看當月流水3. 查看流水 請輸入月份(YYYY-MM直接回車查全部)2025-01輸出示例ID 類型 分類 金額 日期 備注 ------------------------------------------------------------ 3 支出 購物 599.0 2025-01-23 機械鍵盤 2 支出 交通 200.0 2025-01-23 地鐵卡充值 1 支出 餐飲 35.5 2025-01-23 午餐 4 收入 工資 15000.0 2025-01-23 1月工資 ------------------------------------------------------------ 當前篩選結(jié)果總收入 15000.00總支出 834.50操作四查看月度統(tǒng)計4. 月度統(tǒng)計 請輸入月份(YYYY-MM)2025-01 2025-01 月度匯總 收入15000.00 支出834.50 結(jié)余14165.50 支出分類明細 購物599.0071.8% 交通200.0024.0% 餐飲35.504.3% 本月預(yù)算執(zhí)行良好這里能看到分類占比一眼定位大額支出。操作五設(shè)置預(yù)算并觸發(fā)提醒5. 設(shè)置預(yù)算 輸入支出分類購物 輸入預(yù)算金額500 預(yù)算已設(shè)置再次運行月度統(tǒng)計輸出會多出超支提醒預(yù)算提醒 [超支] 購物 預(yù)算 500.0已支出 599.0操作六導(dǎo)出 CSV8. 導(dǎo)出 CSV 輸入導(dǎo)出文件路徑默認 export.csvmy_finance.csv 已導(dǎo)出 4 條記錄到 my_finance.csv打開my_finance.csv可以看到使用utf-8-sig編碼導(dǎo)出的表格Excel 雙擊打開不會亂碼。4.4 數(shù)據(jù)庫驗證我們也可以直接通過sqlite3命令檢查數(shù)據(jù)庫內(nèi)容sqlite3 data/finance.db SELECT * FROM transactions;或者進入交互式環(huán)境sqlite3 data/finance.db .tables .headers on .mode column SELECT * FROM transactions;輸出效果更整齊適合調(diào)試階段確認數(shù)據(jù)是否正確寫入。5. 常見問題與排查思路在實際運行過程中新手經(jīng)常會遇到下面幾類問題。這里整理成表格方便直接對照排查。5.1 通用問題排查表問題現(xiàn)象常見原因解決思路運行python finance.py報ModuleNotFoundError項目目錄不在 Python 路徑中或模塊導(dǎo)入錯誤確認當前目錄是否正確單文件版本不需要導(dǎo)入自定義模塊提示sqlite3.OperationalError: no such table建表代碼沒有執(zhí)行或數(shù)據(jù)庫文件路徑不一致檢查init_db()是否在main()中調(diào)用檢查DB_PATH是否指向同一個文件新增記錄不生效沒有調(diào)用conn.commit()插入后必須執(zhí)行commit()中文數(shù)據(jù)顯示亂碼終端編碼不是 UTF-8Windows 下執(zhí)行chcp 65001或使用set PYTHONIOENCODINGutf-8CSV 用 Excel 打開亂碼導(dǎo)出文件不是utf-8-sig使用encodingutf-8-sig重新導(dǎo)出金額計算結(jié)果有很多小數(shù)浮點數(shù)存儲與累加誤差使用round()格式化顯示要求準確時改為整數(shù)分存儲刪除記錄時誤刪沒有二次確認在生產(chǎn)版本中增加確認提示或使用軟刪除日期篩選查不到數(shù)據(jù)輸入月份格式錯誤確認格式為YYYY-MM例如2025-01不是2025-15.2 關(guān)于浮點精度問題個人記賬場景中金額的小數(shù)位最多兩位但浮點運算是二進制近似可能出現(xiàn)0.1 0.2 0.30000000000000004的情況。文章代碼示例在monthly_summary中使用了round(..., 2)顯示層不會出錯。但在涉及借貸、分賬等對精度敏感的場景建議改為以“分”為單位存儲整數(shù)。例如金額 12.34 元存儲為1234分統(tǒng)計時再除以 100。5.3 關(guān)于 SQL 注入防范代碼中所有 SQL 都使用了參數(shù)占位符?這是推薦做法。如果使用字符串拼接例如# 錯誤示例 sql fSELECT * FROM transactions WHERE category {category}當用戶輸入 OR 11時會把整張表數(shù)據(jù)都查出來。雖然本地工具風險較低但一旦改成 Web 服務(wù)這就是致命漏洞。養(yǎng)成參數(shù)化查詢的習慣是寫 Python 數(shù)據(jù)庫程序的基本要求。5.4 數(shù)據(jù)備份SQLite 數(shù)據(jù)庫只是一個文件備份非常簡單。只要程序不處于寫入狀態(tài)直接復(fù)制.db文件即可cp data/finance.db backup_$(date %Y%m%d).db你甚至可以把備份腳本加到系統(tǒng)計劃任務(wù)中。個人財務(wù)數(shù)據(jù)雖然不如企業(yè)數(shù)據(jù)量大但丟失一樣會造成不便。6. 最佳實踐與工程建議6.1 分類體系與命名規(guī)范分類名的統(tǒng)一是記賬工具最容易忽視的問題。同一個支出有的人記為“餐飲”有的人記為“吃飯”最終統(tǒng)計就會分裂。建議預(yù)置分類并限制輸入就像上面的代碼那樣。如果用戶確實有自定義需求可以提供“增加自定義分類”功能并做去重和別名映射。數(shù)據(jù)庫字段命名建議保持全小寫加下劃線例如limit_amount不要混用駝峰。SQLite 本身對大小寫不敏感但統(tǒng)一風格可以減少后期維護成本。6.2 數(shù)據(jù)處理原則所有新增操作都進行輸入校驗金額、日期、分類不允許直接落庫。使用參數(shù)化查詢不要把用戶輸入拼入 SQL。刪除操作建議加confirm提示或者使用“回收站”機制在表里增加deleted字段。定期導(dǎo)出 CSV 作為外部備份。6.3 擴展方向當前項目已經(jīng)是一個可用的最小閉環(huán)。下一步可以按需要擴展Web 界面化使用 Flask 或 FastAPI 提供 REST API配合簡單前端。數(shù)據(jù)可視化把月度趨勢、分類餅圖用 Matplotlib / ECharts 呈現(xiàn)。多賬戶支持增加賬戶表記錄現(xiàn)金、銀行卡、支付寶余額。統(tǒng)計分析引入環(huán)比、同比計算月度平均支出、儲蓄率。自動分類根據(jù)歷史記錄和備注關(guān)鍵詞自動建議支出分類減少用戶操作。如果你選擇 Web 化注意不要輕易把數(shù)據(jù)庫文件放到公網(wǎng)目錄建議通過后端接口訪問認證和權(quán)限做到最小邊界。部署時優(yōu)先使用localhost綁定即使要用 HTTPS 也要做好鑒權(quán)。6.4 開發(fā)流程建議個人項目同樣推薦遵循三步思維先定義數(shù)據(jù)結(jié)構(gòu)想清楚有哪些實體、字段、關(guān)系。再實現(xiàn)核心鏈路增刪改查必須最小實現(xiàn)。最后優(yōu)化體驗增加預(yù)算提醒、導(dǎo)出、統(tǒng)計報表。不要一開始就追求花哨界面先把數(shù)據(jù)處理正確再考慮美觀。7. 總結(jié)與下一步學習路線本文從一個實際需求出發(fā)實現(xiàn)了本地個人財務(wù)助手核心內(nèi)容包括使用 Python 標準庫sqlite3完成數(shù)據(jù)持久化。設(shè)計了兩張表transactions和budget覆蓋記賬和預(yù)算。實現(xiàn)收入、支出、查詢、月度統(tǒng)計、預(yù)算提醒、CSV 導(dǎo)出等功能。強調(diào)了輸入校驗、參數(shù)化查詢、數(shù)據(jù)處理等工程細節(jié)。整個項目沒有引入第三方大數(shù)據(jù)組件代碼量小邏輯清楚適合作為 Python 入門后的第一個綜合實戰(zhàn)項目。下一步建議分兩條線如果你對數(shù)據(jù)庫感興趣可以學習 SQLite 的索引、事務(wù)、視圖嘗試把當前逐條查詢優(yōu)化為按月生成視圖或者增加索引來提升大數(shù)據(jù)量下的查詢速度。如果你對應(yīng)用層感興趣可以基于現(xiàn)有代碼封裝 Flask API做一個瀏覽器版本的記賬面板進一步練習前后端分離、接口設(shè)計和部署。最后提醒一下本地工具雖然不像云服務(wù)那樣需要考慮復(fù)雜權(quán)限但“最小權(quán)限”原則依然適用——不要讓不必要的功能暴露不要忽略數(shù)據(jù)備份。財務(wù)數(shù)據(jù)是個人敏感數(shù)據(jù)能用本地解決的需求就盡量留在本地。如果這篇文章對你有幫助可以收藏備用動手實現(xiàn)一個屬于你自己的財務(wù)助手。 用Python和SQLite構(gòu)建離線個人財務(wù)助手
本地個人財務(wù)助手可以做到完全離線運行你的賬單、預(yù)算、分類統(tǒng)計都保存在自己電腦上不依賴云端服務(wù)也不用擔心第三方讀取數(shù)據(jù)。本文將從需求拆解開始帶你實現(xiàn)一個基于 Python 和 SQLite 的本地個人財務(wù)助手包含收入支出記賬、分類統(tǒng)計、月度報表、預(yù)算提醒和 CSV 導(dǎo)入導(dǎo)出等功能。內(nèi)容覆蓋數(shù)據(jù)庫設(shè)計、命令行交互、數(shù)據(jù)校驗和常見報錯排查適合有一定 Python 基礎(chǔ)、想動手做工具類項目的開發(fā)者。1. 什么是本地個人財務(wù)助手1.1 從記賬需求說起很多人都有記賬的想法但堅持下來的并不多。市面上大多數(shù)記賬 App 都依賴云端同步雖然方便但存在幾個問題數(shù)據(jù)不在自己手里、訂閱費用不低、功能過于復(fù)雜、廣告和社區(qū)內(nèi)容干擾體驗。本地個人財務(wù)助手解決的就是這類痛點。它把數(shù)據(jù)保存在本地文件中例如 SQLite 數(shù)據(jù)庫所有增刪改查操作都在本機完成。用戶通過命令行、終端界面或者一個簡單的 Web 頁面與程序交互沒有網(wǎng)絡(luò)請求沒有用戶畫像也不需要注冊賬號。從開發(fā)角度看這類項目非常適合用來練習 Python 的文件處理、數(shù)據(jù)庫操作、異常捕獲和面向?qū)ο笤O(shè)計。它不像電商系統(tǒng)那樣龐大但已經(jīng)具備了一個完整業(yè)務(wù)系統(tǒng)的核心鏈路輸入校驗、數(shù)據(jù)存儲、統(tǒng)計匯總、報表輸出。1.2 本地財務(wù)助手與云端記賬軟件的區(qū)別對比維度本地財務(wù)助手云端記賬軟件數(shù)據(jù)存儲本地 SQLite / CSV云端服務(wù)器網(wǎng)絡(luò)依賴無必須聯(lián)網(wǎng)數(shù)據(jù)隱私完全本地隱私性強依賴服務(wù)商安全策略自定義能力高代碼即需求受產(chǎn)品功能限制多端同步不支持或需自行實現(xiàn)原生支持成本免費訂閱制或內(nèi)購如果你的數(shù)據(jù)敏感度比較高或者只是想通過一個小項目學習編程本地方案是更好的選擇。1.3 本文技術(shù)方案概覽本文選用的技術(shù)棧非常簡單Python 3.10SQLite3Python 標準庫自帶argparse 或 input() 交互prettytable 或直接格式化輸出pandas可選用于報表導(dǎo)出最終實現(xiàn)的效果是在終端運行python finance.py后進入交互菜單可以記賬、查賬、統(tǒng)計、設(shè)置預(yù)算、導(dǎo)入導(dǎo)出 CSV。項目結(jié)構(gòu)清晰代碼量控制在 600 行到 800 行之間適合閱讀和維護。2. 環(huán)境準備與項目結(jié)構(gòu)2.1 準備開發(fā)環(huán)境本文示例代碼基于 Python 3.10 編寫SQLite3 是 Python 標準庫不需要額外安裝。如果你的系統(tǒng)還沒有 Python建議先安裝 Python 3.10 或更高版本。檢查 Python 版本python --version在部分 Linux 系統(tǒng)中可能需要使用python3命令。確認版本沒問題后創(chuàng)建一個新的項目目錄mkdir finance-assistant cd finance-assistant建議在項目中使用虛擬環(huán)境避免污染全局 Python 包。當然由于本項目只依賴標準庫不創(chuàng)建虛擬環(huán)境也能正常運行。如果你想后續(xù)加入pandas或prettytable最好先創(chuàng)建虛擬環(huán)境。python -m venv venv source venv/bin/activate # Linux / macOS venv\Scripts\activate # Windows2.2 項目文件結(jié)構(gòu)推薦采用如下結(jié)構(gòu)finance-assistant/ ├── finance.py # 主程序入口交互菜單 ├── database.py # 數(shù)據(jù)庫連接和初始化 ├── models.py # 數(shù)據(jù)模型與校驗函數(shù) ├── reports.py # 報表統(tǒng)計 ├── utils.py # 工具函數(shù)如日期驗證、格式化 ├── data/ │ └── finance.db # SQLite 數(shù)據(jù)庫文件自動生成 └── requirements.txt # 依賴文件可無當然如果你希望快速上手也可以把所有代碼寫進一個文件。本文為了講解清晰按職責拆分模塊這樣更接近真實項目的組織方式。2.3 初始化 SQLite 數(shù)據(jù)庫SQLite 是一種嵌入式關(guān)系型數(shù)據(jù)庫不需要獨立服務(wù)進程數(shù)據(jù)保存在單個.db文件中。Python 內(nèi)置了sqlite3模塊可以直接操作。在database.py中創(chuàng)建數(shù)據(jù)庫連接并建表# database.py import sqlite3 import os DB_PATH os.path.join(os.path.dirname(__file__), data, finance.db) def get_connection(): os.makedirs(os.path.dirname(DB_PATH), exist_okTrue) conn sqlite3.connect(DB_PATH) conn.row_factory sqlite3.Row return conn def init_db(): conn get_connection() cursor conn.cursor() cursor.execute( CREATE TABLE IF NOT EXISTS transactions ( id INTEGER PRIMARY KEY AUTOINCREMENT, type TEXT NOT NULL CHECK(type IN (income, expense)), category TEXT NOT NULL, amount REAL NOT NULL, date TEXT NOT NULL, note TEXT DEFAULT ) ) cursor.execute( CREATE TABLE IF NOT EXISTS budget ( category TEXT PRIMARY KEY, limit_amount REAL NOT NULL ) ) conn.commit() conn.close()這里有兩個核心表transactions存儲每一筆收入或支出記錄包含類型、分類、金額、日期、備注。budget存儲每個分類的預(yù)算上限用于超支提醒。字段設(shè)計很簡潔但已經(jīng)能覆蓋常見個人記賬場景。如果后續(xù)要擴展家庭成員、賬戶、標簽等功能可以在此基礎(chǔ)上加表或加字段。3. 核心功能設(shè)計與代碼實現(xiàn)3.1 數(shù)據(jù)模型與輸入校驗在models.py中定義分類常量、數(shù)據(jù)校驗函數(shù)。分類不建議完全自由輸入否則統(tǒng)計時會很混亂。我們預(yù)置一份默認分類# models.py INCOME_CATEGORIES [工資, 獎金, 理財, 兼職, 其他收入] EXPENSE_CATEGORIES [餐飲, 交通, 購物, 居住, 娛樂, 醫(yī)療, 教育, 其他支出] VALID_TYPES (income, expense) def validate_amount(amount_str): try: amount float(amount_str) if amount 0: raise ValueError(金額必須大于 0) if amount 100000000: raise ValueError(金額超出合理范圍) return round(amount, 2) except ValueError as e: raise ValueError(f金額無效{e}) def validate_date(date_str): from datetime import datetime try: datetime.strptime(date_str, %Y-%m-%d) return date_str except ValueError: raise ValueError(日期格式應(yīng)為 YYYY-MM-DD例如 2025-01-15)這里有幾個設(shè)計考慮金額使用REAL類型存儲雖然存在浮點精度問題但個人記賬金額精度要求不高。如果要求精確計算可以使用整數(shù)分存儲或者用DECIMAL。金額必須大于 0且不能超過一個較大閾值避免誤輸入。日期統(tǒng)一使用字符串YYYY-MM-DD方便比較和排序。3.2 數(shù)據(jù)庫操作封裝在database.py中繼續(xù)添加增刪查函數(shù)def add_transaction(txn_type, category, amount, date, note): conn get_connection() cursor conn.cursor() cursor.execute( INSERT INTO transactions (type, category, amount, date, note) VALUES (?, ?, ?, ?, ?) , (txn_type, category, amount, date, note)) conn.commit() conn.close() def get_transactions(start_dateNone, end_dateNone, txn_typeNone): conn get_connection() cursor conn.cursor() sql SELECT * FROM transactions WHERE 11 params [] if start_date: sql AND date ? params.append(start_date) if end_date: sql AND date ? params.append(end_date) if txn_type: sql AND type ? params.append(txn_type) sql ORDER BY date DESC, id DESC cursor.execute(sql, params) rows cursor.fetchall() conn.close() return [dict(row) for row in rows] def delete_transaction(txn_id): conn get_connection() cursor conn.cursor() cursor.execute(DELETE FROM transactions WHERE id ?, (txn_id,)) conn.commit() deleted cursor.rowcount conn.close() return deleted 0使用參數(shù)化查詢的?占位符而不是直接拼接字符串這是為了防止 SQL 注入。即使這是本地單機應(yīng)用也應(yīng)該養(yǎng)成良好習慣。3.3 交互菜單設(shè)計主程序finance.py使用input()循環(huán)顯示菜單。為了讓輸出更清晰寫一個show_menu函數(shù)# finance.py from database import init_db, add_transaction, get_transactions, delete_transaction from models import ( INCOME_CATEGORIES, EXPENSE_CATEGORIES, validate_amount, validate_date, ) def main(): init_db() while True: print( 本地個人財務(wù)助手 1. 記一筆收入 2. 記一筆支出 3. 查看流水 4. 月度統(tǒng)計 5. 設(shè)置/查看預(yù)算 6. 刪除記錄 7. 導(dǎo)出 CSV 8. 退出 ) choice input(請輸入選項).strip() if choice 1: handle_income() elif choice 2: handle_expense() elif choice 3: handle_query() # ... 其他分支 elif choice 8: print(再見) break else: print(無效選項請重新輸入)每個處理函數(shù)都要做好異常捕獲避免因為用戶輸入不合法導(dǎo)致程序崩潰。例如收入錄入函數(shù)def handle_income(): print(收入分類 、.join(INCOME_CATEGORIES)) category input(請輸入收入分類).strip() if category not in INCOME_CATEGORIES: print(分類不合法) return try: amount validate_amount(input(請輸入金額).strip()) date validate_date(input(請輸入日期YYYY-MM-DD直接回車使用今天).strip() or today()) note input(請輸入備注).strip() add_transaction(income, category, amount, date, note) print(收入記錄已添加) except ValueError as e: print(f輸入錯誤{e})這種寫法有兩個好處每一類輸入都有獨立驗證任何一步出錯都只提示錯誤不會中斷主循環(huán)。3.4 報表統(tǒng)計實現(xiàn)報表是財務(wù)助手最實用的功能。我們需要實現(xiàn)按月份匯總收入、支出、結(jié)余。按分類匯總支出占比。預(yù)算超支提醒。在reports.py中編寫def monthly_summary(year_month): year_month 格式2025-01 conn get_connection() cursor conn.cursor() cursor.execute( SELECT type, SUM(amount) as total FROM transactions WHERE substr(date, 1, 7) ? GROUP BY type , (year_month,)) rows cursor.fetchall() result {income: 0, expense: 0} for row in rows: result[row[type]] round(row[total], 2) result[balance] round(result[income] - result[expense], 2) conn.close() return result def category_expense(year_month): conn get_connection() cursor conn.cursor() cursor.execute( SELECT category, SUM(amount) as total FROM transactions WHERE type expense AND substr(date, 1, 7) ? GROUP BY category ORDER BY total DESC , (year_month,)) rows cursor.fetchall() conn.close() return [dict(row) for row in rows]substr(date, 1, 7)是 SQLite 截取字符串前 7 位的函數(shù)正好對應(yīng)YYYY-MM。這種方法簡單高效不需要額外的時間函數(shù)。預(yù)算提醒邏輯def check_budget(year_month): budget_rows get_all_budget() expense_rows category_expense(year_month) alerts [] for b in budget_rows: spent 0 for e in expense_rows: if e[category] b[category]: spent e[total] break if spent b[limit_amount]: alerts.append(f{b[category]} 已超支預(yù)算 {b[limit_amount]}已用 {spent}) elif spent b[limit_amount] * 0.8: alerts.append(f{b[category]} 即將超支預(yù)算剩余不足 20%) return alerts“已用超過 80%”的提醒非常實用相當于把預(yù)算管理前置而不是等超支了才知道。4. 完整實戰(zhàn)案例下面我們從一個“新用戶”的視角把整個項目完整實現(xiàn)并跑通。這里采用單文件版本方便復(fù)制測試如果你想拆成多個模塊思路完全一樣。4.1 安裝依賴本項目單獨運行只需要標準庫不用安裝任何第三方包。如果你希望表格輸出更美觀可以安裝prettytablepip install prettytable但在完整代碼中為了零依賴運行我們手動格式化輸出避免安裝步驟。4.2 完整代碼下面是一個完整的finance.py文件通過注釋說明每一部分的功能。# finance.py import sqlite3 import os from datetime import datetime import csv DB_PATH os.path.join(os.path.dirname(__file__), data, finance.db) INCOME_CATEGORIES [工資, 獎金, 理財, 兼職, 其他收入] EXPENSE_CATEGORIES [餐飲, 交通, 購物, 居住, 娛樂, 醫(yī)療, 教育, 其他支出] def get_conn(): os.makedirs(os.path.dirname(DB_PATH), exist_okTrue) conn sqlite3.connect(DB_PATH) conn.row_factory sqlite3.Row return conn def init_db(): conn get_conn() conn.executescript( CREATE TABLE IF NOT EXISTS transactions ( id INTEGER PRIMARY KEY AUTOINCREMENT, type TEXT NOT NULL CHECK(type IN (income, expense)), category TEXT NOT NULL, amount REAL NOT NULL, date TEXT NOT NULL, note TEXT DEFAULT ); CREATE TABLE IF NOT EXISTS budget ( category TEXT PRIMARY KEY, limit_amount REAL NOT NULL ); ) conn.commit() conn.close() def validate_amount(value): try: amount float(value) if amount 0: raise ValueError(金額必須大于0) return round(amount, 2) except ValueError as e: raise ValueError(金額必須是有效數(shù)字) from e def validate_date(value): try: datetime.strptime(value, %Y-%m-%d) return value except ValueError: raise ValueError(日期格式必須為 YYYY-MM-DD) def today_str(): return datetime.now().strftime(%Y-%m-%d) def add_record(txn_type, category, amount, date, note): conn get_conn() conn.execute( INSERT INTO transactions (type, category, amount, date, note) VALUES (?, ?, ?, ?, ?), (txn_type, category, amount, date, note), ) conn.commit() conn.close() def query_records(monthNone, txn_typeNone): conn get_conn() sql SELECT * FROM transactions WHERE 11 params [] if month: sql AND substr(date, 1, 7) ? params.append(month) if txn_type: sql AND type ? params.append(txn_type) sql ORDER BY date DESC, id DESC rows conn.execute(sql, params).fetchall() conn.close() return [dict(r) for r in rows] def delete_record(record_id): conn get_conn() cur conn.execute(DELETE FROM transactions WHERE id ?, (record_id,)) conn.commit() conn.close() return cur.rowcount 0 def set_budget(category, limit_amount): conn get_conn() conn.execute( INSERT INTO budget (category, limit_amount) VALUES (?, ?) ON CONFLICT(category) DO UPDATE SET limit_amount excluded.limit_amount, (category, limit_amount), ) conn.commit() conn.close() def get_budgets(): conn get_conn() rows conn.execute(SELECT * FROM budget).fetchall() conn.close() return [dict(r) for r in rows] def monthly_summary(month): conn get_conn() rows conn.execute( SELECT type, SUM(amount) AS total FROM transactions WHERE substr(date, 1, 7) ? GROUP BY type, (month,), ).fetchall() conn.close() result {income: 0, expense: 0} for r in rows: result[r[type]] round(r[total], 2) result[balance] round(result[income] - result[expense], 2) return result def category_expense(month): conn get_conn() rows conn.execute( SELECT category, SUM(amount) AS total FROM transactions WHERE type expense AND substr(date, 1, 7) ? GROUP BY category ORDER BY total DESC, (month,), ).fetchall() conn.close() return [dict(r) for r in rows] def budget_alerts(month): budgets get_budgets() expenses category_expense(month) alert_list [] for b in budgets: spent 0 for e in expenses: if e[category] b[category]: spent e[total] break if spent b[limit_amount]: alert_list.append(f[超支] {b[category]} 預(yù)算 {b[limit_amount]}已支出 {spent}) elif b[limit_amount] 0 and spent b[limit_amount] * 0.8: alert_list.append(f[提醒] {b[category]} 已使用預(yù)算的 {spent/b[limit_amount]*100:.1f}%) return alert_list def export_csv(filepath): conn get_conn() rows conn.execute(SELECT * FROM transactions ORDER BY date).fetchall() conn.close() with open(filepath, w, newline, encodingutf-8-sig) as f: writer csv.writer(f) writer.writerow([ID, 類型, 分類, 金額, 日期, 備注]) for r in rows: type_cn 收入 if r[type] income else 支出 writer.writerow([r[id], type_cn, r[category], r[amount], r[date], r[note]]) return len(rows) def input_income(): print(可選分類 、.join(INCOME_CATEGORIES)) category input(收入分類).strip() if category not in INCOME_CATEGORIES: print(輸入錯誤分類不在可選列表中) return try: amount validate_amount(input(金額).strip()) date input(日期(YYYY-MM-DD直接回車用今天)).strip() or today_str() date validate_date(date) note input(備注).strip() add_record(income, category, amount, date, note) print(? 收入記錄已保存) except ValueError as e: print(f輸入錯誤{e}) def input_expense(): print(可選分類 、.join(EXPENSE_CATEGORIES)) category input(支出分類).strip() if category not in EXPENSE_CATEGORIES: print(輸入錯誤分類不在可選列表中) return try: amount validate_amount(input(金額).strip()) date input(日期(YYYY-MM-DD直接回車用今天)).strip() or today_str() date validate_date(date) note input(備注).strip() add_record(expense, category, amount, date, note) print(? 支出記錄已保存) except ValueError as e: print(f輸入錯誤{e}) def show_query(): month input(請輸入月份(YYYY-MM直接回車查全部)).strip() rows query_records(monthmonth) if month else query_records() if not rows: print(暫無記錄) return print(f{ID:5}{類型:6}{分類:10}{金額:12}{日期:12}{備注}) print(- * 60) for r in rows: type_cn 收入 if r[type] income else 支出 print(f{r[id]:5}{type_cn:6}{r[category]:10}{r[amount]:12}{r[date]:12}{r[note]}) total_income sum(r[amount] for r in rows if r[type] income) total_expense sum(r[amount] for r in rows if r[type] expense) print(- * 60) print(f當前篩選結(jié)果總收入 {total_income:.2f}總支出 {total_expense:.2f}) def show_monthly_report(): month input(請輸入月份(YYYY-MM)).strip() if not month: print(月份不能為空) return summary monthly_summary(month) print(f\n {month} 月度匯總 ) print(f收入{summary[income]:.2f}) print(f支出{summary[expense]:.2f}) print(f結(jié)余{summary[balance]:.2f}) print(\n支出分類明細) exp_rows category_expense(month) if not exp_rows: print(該月暫無支出) else: total_exp summary[expense] for e in exp_rows: percent e[total] / total_exp * 100 if total_exp else 0 print(f{e[category]}{e[total]:.2f}{percent:.1f}%) alerts budget_alerts(month) if alerts: print(\n預(yù)算提醒) for a in alerts: print(a) else: print(\n本月預(yù)算執(zhí)行良好) def main(): init_db() print(歡迎使用本地個人財務(wù)助手) while True: print( 主菜單 1. 記一筆收入 2. 記一筆支出 3. 查看流水 4. 月度統(tǒng)計 5. 設(shè)置預(yù)算 6. 查看預(yù)算 7. 刪除記錄 8. 導(dǎo)出 CSV 9. 退出 ) choice input(請輸入選項).strip() if choice 1: input_income() elif choice 2: input_expense() elif choice 3: show_query() elif choice 4: show_monthly_report() elif choice 5: try: cat input(輸入支出分類).strip() if cat not in EXPENSE_CATEGORIES: print(分類不合法) continue amt validate_amount(input(輸入預(yù)算金額).strip()) set_budget(cat, amt) print(預(yù)算已設(shè)置) except ValueError as e: print(f輸入錯誤{e}) elif choice 6: budgets get_budgets() if not budgets: print(還沒有設(shè)置預(yù)算) else: for b in budgets: print(f{b[category]}{b[limit_amount]:.2f}) elif choice 7: try: rid int(input(輸入要刪除的記錄 ID).strip()) if delete_record(rid): print(記錄已刪除) else: print(沒有找到該記錄) except ValueError: print(ID 必須是數(shù)字) elif choice 8: path input(輸入導(dǎo)出文件路徑默認 export.csv).strip() or export.csv try: count export_csv(path) print(f已導(dǎo)出 {count} 條記錄到 {path}) except Exception as e: print(f導(dǎo)出失敗{e}) elif choice 9: print(再見祝財務(wù)健康) break else: print(無效選項請重新輸入) if __name__ __main__: main()這段代碼可以直接保存為finance.py后運行。注意data目錄會自動創(chuàng)建不需要手動建。4.3 運行演示在項目目錄下執(zhí)行python finance.py首次運行會自動創(chuàng)建data/finance.db以及兩張表。接著演示一下完整操作流程。操作一記一筆收入1. 記一筆收入 可選分類工資、獎金、理財、兼職、其他收入 收入分類工資 金額15000 日期(YYYY-MM-DD直接回車用今天) 備注1月工資 ? 收入記錄已保存操作二記幾筆支出2. 記一筆支出 可選分類餐飲、交通、購物、居住、娛樂、醫(yī)療、教育、其他支出 支出分類餐飲 金額35.5 日期(YYYY-MM-DD直接回車用今天) 備注午餐 ? 支出記錄已保存再記錄一筆交通和一筆購物支出分類交通 金額200 備注地鐵卡充值支出分類購物 金額599 備注機械鍵盤操作三查看當月流水3. 查看流水 請輸入月份(YYYY-MM直接回車查全部)2025-01輸出示例ID 類型 分類 金額 日期 備注 ------------------------------------------------------------ 3 支出 購物 599.0 2025-01-23 機械鍵盤 2 支出 交通 200.0 2025-01-23 地鐵卡充值 1 支出 餐飲 35.5 2025-01-23 午餐 4 收入 工資 15000.0 2025-01-23 1月工資 ------------------------------------------------------------ 當前篩選結(jié)果總收入 15000.00總支出 834.50操作四查看月度統(tǒng)計4. 月度統(tǒng)計 請輸入月份(YYYY-MM)2025-01 2025-01 月度匯總 收入15000.00 支出834.50 結(jié)余14165.50 支出分類明細 購物599.0071.8% 交通200.0024.0% 餐飲35.504.3% 本月預(yù)算執(zhí)行良好這里能看到分類占比一眼定位大額支出。操作五設(shè)置預(yù)算并觸發(fā)提醒5. 設(shè)置預(yù)算 輸入支出分類購物 輸入預(yù)算金額500 預(yù)算已設(shè)置再次運行月度統(tǒng)計輸出會多出超支提醒預(yù)算提醒 [超支] 購物 預(yù)算 500.0已支出 599.0操作六導(dǎo)出 CSV8. 導(dǎo)出 CSV 輸入導(dǎo)出文件路徑默認 export.csvmy_finance.csv 已導(dǎo)出 4 條記錄到 my_finance.csv打開my_finance.csv可以看到使用utf-8-sig編碼導(dǎo)出的表格Excel 雙擊打開不會亂碼。4.4 數(shù)據(jù)庫驗證我們也可以直接通過sqlite3命令檢查數(shù)據(jù)庫內(nèi)容sqlite3 data/finance.db SELECT * FROM transactions;或者進入交互式環(huán)境sqlite3 data/finance.db .tables .headers on .mode column SELECT * FROM transactions;輸出效果更整齊適合調(diào)試階段確認數(shù)據(jù)是否正確寫入。5. 常見問題與排查思路在實際運行過程中新手經(jīng)常會遇到下面幾類問題。這里整理成表格方便直接對照排查。5.1 通用問題排查表問題現(xiàn)象常見原因解決思路運行python finance.py報ModuleNotFoundError項目目錄不在 Python 路徑中或模塊導(dǎo)入錯誤確認當前目錄是否正確單文件版本不需要導(dǎo)入自定義模塊提示sqlite3.OperationalError: no such table建表代碼沒有執(zhí)行或數(shù)據(jù)庫文件路徑不一致檢查init_db()是否在main()中調(diào)用檢查DB_PATH是否指向同一個文件新增記錄不生效沒有調(diào)用conn.commit()插入后必須執(zhí)行commit()中文數(shù)據(jù)顯示亂碼終端編碼不是 UTF-8Windows 下執(zhí)行chcp 65001或使用set PYTHONIOENCODINGutf-8CSV 用 Excel 打開亂碼導(dǎo)出文件不是utf-8-sig使用encodingutf-8-sig重新導(dǎo)出金額計算結(jié)果有很多小數(shù)浮點數(shù)存儲與累加誤差使用round()格式化顯示要求準確時改為整數(shù)分存儲刪除記錄時誤刪沒有二次確認在生產(chǎn)版本中增加確認提示或使用軟刪除日期篩選查不到數(shù)據(jù)輸入月份格式錯誤確認格式為YYYY-MM例如2025-01不是2025-15.2 關(guān)于浮點精度問題個人記賬場景中金額的小數(shù)位最多兩位但浮點運算是二進制近似可能出現(xiàn)0.1 0.2 0.30000000000000004的情況。文章代碼示例在monthly_summary中使用了round(..., 2)顯示層不會出錯。但在涉及借貸、分賬等對精度敏感的場景建議改為以“分”為單位存儲整數(shù)。例如金額 12.34 元存儲為1234分統(tǒng)計時再除以 100。5.3 關(guān)于 SQL 注入防范代碼中所有 SQL 都使用了參數(shù)占位符?這是推薦做法。如果使用字符串拼接例如# 錯誤示例 sql fSELECT * FROM transactions WHERE category {category}當用戶輸入 OR 11時會把整張表數(shù)據(jù)都查出來。雖然本地工具風險較低但一旦改成 Web 服務(wù)這就是致命漏洞。養(yǎng)成參數(shù)化查詢的習慣是寫 Python 數(shù)據(jù)庫程序的基本要求。5.4 數(shù)據(jù)備份SQLite 數(shù)據(jù)庫只是一個文件備份非常簡單。只要程序不處于寫入狀態(tài)直接復(fù)制.db文件即可cp data/finance.db backup_$(date %Y%m%d).db你甚至可以把備份腳本加到系統(tǒng)計劃任務(wù)中。個人財務(wù)數(shù)據(jù)雖然不如企業(yè)數(shù)據(jù)量大但丟失一樣會造成不便。6. 最佳實踐與工程建議6.1 分類體系與命名規(guī)范分類名的統(tǒng)一是記賬工具最容易忽視的問題。同一個支出有的人記為“餐飲”有的人記為“吃飯”最終統(tǒng)計就會分裂。建議預(yù)置分類并限制輸入就像上面的代碼那樣。如果用戶確實有自定義需求可以提供“增加自定義分類”功能并做去重和別名映射。數(shù)據(jù)庫字段命名建議保持全小寫加下劃線例如limit_amount不要混用駝峰。SQLite 本身對大小寫不敏感但統(tǒng)一風格可以減少后期維護成本。6.2 數(shù)據(jù)處理原則所有新增操作都進行輸入校驗金額、日期、分類不允許直接落庫。使用參數(shù)化查詢不要把用戶輸入拼入 SQL。刪除操作建議加confirm提示或者使用“回收站”機制在表里增加deleted字段。定期導(dǎo)出 CSV 作為外部備份。6.3 擴展方向當前項目已經(jīng)是一個可用的最小閉環(huán)。下一步可以按需要擴展Web 界面化使用 Flask 或 FastAPI 提供 REST API配合簡單前端。數(shù)據(jù)可視化把月度趨勢、分類餅圖用 Matplotlib / ECharts 呈現(xiàn)。多賬戶支持增加賬戶表記錄現(xiàn)金、銀行卡、支付寶余額。統(tǒng)計分析引入環(huán)比、同比計算月度平均支出、儲蓄率。自動分類根據(jù)歷史記錄和備注關(guān)鍵詞自動建議支出分類減少用戶操作。如果你選擇 Web 化注意不要輕易把數(shù)據(jù)庫文件放到公網(wǎng)目錄建議通過后端接口訪問認證和權(quán)限做到最小邊界。部署時優(yōu)先使用localhost綁定即使要用 HTTPS 也要做好鑒權(quán)。6.4 開發(fā)流程建議個人項目同樣推薦遵循三步思維先定義數(shù)據(jù)結(jié)構(gòu)想清楚有哪些實體、字段、關(guān)系。再實現(xiàn)核心鏈路增刪改查必須最小實現(xiàn)。最后優(yōu)化體驗增加預(yù)算提醒、導(dǎo)出、統(tǒng)計報表。不要一開始就追求花哨界面先把數(shù)據(jù)處理正確再考慮美觀。7. 總結(jié)與下一步學習路線本文從一個實際需求出發(fā)實現(xiàn)了本地個人財務(wù)助手核心內(nèi)容包括使用 Python 標準庫sqlite3完成數(shù)據(jù)持久化。設(shè)計了兩張表transactions和budget覆蓋記賬和預(yù)算。實現(xiàn)收入、支出、查詢、月度統(tǒng)計、預(yù)算提醒、CSV 導(dǎo)出等功能。強調(diào)了輸入校驗、參數(shù)化查詢、數(shù)據(jù)處理等工程細節(jié)。整個項目沒有引入第三方大數(shù)據(jù)組件代碼量小邏輯清楚適合作為 Python 入門后的第一個綜合實戰(zhàn)項目。下一步建議分兩條線如果你對數(shù)據(jù)庫感興趣可以學習 SQLite 的索引、事務(wù)、視圖嘗試把當前逐條查詢優(yōu)化為按月生成視圖或者增加索引來提升大數(shù)據(jù)量下的查詢速度。如果你對應(yīng)用層感興趣可以基于現(xiàn)有代碼封裝 Flask API做一個瀏覽器版本的記賬面板進一步練習前后端分離、接口設(shè)計和部署。最后提醒一下本地工具雖然不像云服務(wù)那樣需要考慮復(fù)雜權(quán)限但“最小權(quán)限”原則依然適用——不要讓不必要的功能暴露不要忽略數(shù)據(jù)備份。財務(wù)數(shù)據(jù)是個人敏感數(shù)據(jù)能用本地解決的需求就盡量留在本地。如果這篇文章對你有幫助可以收藏備用動手實現(xiàn)一個屬于你自己的財務(wù)助手。