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