簡(jiǎn)介面向房東、物業(yè)及小微企業(yè)收款人員的房租水電費(fèi)收據(jù)打印工具聚焦房租、押金、水費(fèi)、電費(fèi)、燃?xì)赓M(fèi)等日常收款場(chǎng)景意在替代手寫收據(jù)和Excel對(duì)賬的繁瑣流程。軟件將收據(jù)管理、出租房管理、客戶資料庫與數(shù)據(jù)分析整合在一起支持即輸即打、單據(jù)編號(hào)自定義、金額自動(dòng)計(jì)算與大小寫轉(zhuǎn)換、批量打印、按收據(jù)生成對(duì)賬單并可將數(shù)據(jù)或單據(jù)導(dǎo)出為Excel、圖片、PDF提供打印樣式自定義及導(dǎo)入導(dǎo)出、數(shù)據(jù)備份恢復(fù)、U盤便攜使用等功能。包體為zip壓縮包約3.39MB上游未提供可核驗(yàn)的文件總數(shù)與主要文件類型明細(xì)具體以實(shí)際包內(nèi)內(nèi)容為準(zhǔn)。資源頁顯示已有292人瀏覽學(xué)習(xí)適合需要規(guī)范開具房租水電收據(jù)、減少手工錄入與對(duì)賬差錯(cuò)的個(gè)人房東、公寓管理者和中小商戶參考使用。1. 房租水電費(fèi)收據(jù)打印把月底最臟的活壓成一條命令月底最后一天二三十套房、四五十個(gè)租戶的水電表數(shù)還散在兩三個(gè) Excel 和一堆聊天記錄里手寫收據(jù)寫到手腕發(fā)酸寫錯(cuò)一個(gè)字整張重來。房租水電費(fèi)收據(jù)打印這件事真正麻煩的地方不在打印而在把抄表數(shù)、租金、水電單價(jià)、上期欠費(fèi)合成一張能直接撕給租戶的兩聯(lián)票據(jù)同時(shí)把編號(hào)、留底、跨月對(duì)賬一起管住。它不適合大型物業(yè)的全套計(jì)費(fèi)系統(tǒng)但對(duì)付幾十套自持房源、每月集中開一次票的場(chǎng)景比通用財(cái)務(wù)軟件順手得多。這篇按我實(shí)際落地的順序走先把數(shù)據(jù)模型立住再解決算錢再解決套打坐標(biāo)最后講那些只有真打過錯(cuò)位票據(jù)才懂的坑。2. 收據(jù)的數(shù)據(jù)底座房間、租戶、抄表、賬單四張表怎么拆2.1 房租水電費(fèi)收據(jù)打印為什么不能只靠一張 Excel 模板用 Excel 做郵件合并出收據(jù)第一年確實(shí)夠用。房源數(shù)量一過二十套問題就一茬接一茬地冒出來編號(hào)靠手填兩個(gè)人同時(shí)開單必然撞號(hào)收據(jù)打廢了重打一張舊號(hào)是作廢還是留著表格里根本看不出來租戶中途退租按天折算的租金在下個(gè)月對(duì)賬時(shí)已經(jīng)找不到計(jì)算依據(jù)更麻煩的是歷史數(shù)據(jù)——你想查某個(gè)房間過去十二個(gè)月的水電用量曲線得手工把十二張表拼起來。把數(shù)據(jù)拆成四張表的理由很樸素房間和租戶是相對(duì)穩(wěn)定的事實(shí)抄表讀數(shù)和賬單是按月追加的事件。穩(wěn)定的事實(shí)改動(dòng)少、可以放心做外鍵按月追加的事件只允許插入、不允許覆蓋否則一旦算錯(cuò)連回滾的基準(zhǔn)都沒有。賬單和收據(jù)還要再拆一層——賬單是可重算的業(yè)務(wù)結(jié)果收據(jù)是已經(jīng)交給租戶的憑證兩者的生命周期完全不同。賬單算錯(cuò)了可以作廢重開收據(jù)一旦遞出去只能標(biāo)記作廢后另開一張新號(hào)的絕不能改數(shù)字。這個(gè)拆分帶來的直接好處是出票失敗、打印機(jī)卡紙、租戶要求補(bǔ)打都只是往收據(jù)表里插一條新記錄賬單本身不動(dòng)月底對(duì)賬時(shí)應(yīng)收看賬單表已開票看收據(jù)表兩者的差額就是還沒送到租戶手上的那部分工作量。2.2 四張表的建表語句與字段取舍SQLite 最省事單文件、免安裝、拷走就能換機(jī)器和這類輕量工具的氣質(zhì)匹配。下面這套結(jié)構(gòu)在生產(chǎn)里跑了兩年多改動(dòng)很少。-- 金額統(tǒng)一用 INTEGER 存分任何情況下不落 REAL CREATE TABLE room ( id INTEGER PRIMARY KEY, code TEXT NOT NULL UNIQUE, -- 房號(hào)A-302導(dǎo)入前統(tǒng)一大寫去空格 area REAL NOT NULL DEFAULT 0, -- 建筑面積只用于公攤分?jǐn)?rent_cent INTEGER NOT NULL, -- 月租金分 status TEXT NOT NULL DEFAULT vacant -- vacant / rented ); CREATE TABLE tenant ( id INTEGER PRIMARY KEY, room_id INTEGER NOT NULL REFERENCES room(id), name TEXT NOT NULL, phone TEXT, start_date TEXT NOT NULL, -- ISO 86012024-03-01 end_date TEXT, -- NULL 表示在租 deposit_cent INTEGER NOT NULL DEFAULT 0 ); CREATE TABLE meter_reading ( id INTEGER PRIMARY KEY, room_id INTEGER NOT NULL REFERENCES room(id), kind TEXT NOT NULL, -- water / electric read_at TEXT NOT NULL, -- 抄表日 value REAL NOT NULL, -- 本期表讀數(shù) prev_value REAL, -- 上期讀數(shù)冗余存一份用于校驗(yàn)與追溯 source TEXT DEFAULT manual -- manual / photo / import ); CREATE TABLE bill ( id INTEGER PRIMARY KEY, room_id INTEGER NOT NULL REFERENCES room(id), period TEXT NOT NULL, -- 2024-06 rent_cent INTEGER NOT NULL DEFAULT 0, water_cent INTEGER NOT NULL DEFAULT 0, elec_cent INTEGER NOT NULL DEFAULT 0, other_cent INTEGER NOT NULL DEFAULT 0, -- 衛(wèi)生費(fèi)、車位、滯納金 total_cent INTEGER NOT NULL, status TEXT NOT NULL DEFAULT open, -- open / paid / void UNIQUE (room_id, period) -- 同一房間同一賬期只能有一張有效賬單 ); CREATE TABLE receipt ( id INTEGER PRIMARY KEY, bill_id INTEGER NOT NULL REFERENCES bill(id), serial TEXT NOT NULL UNIQUE, -- 收據(jù)號(hào)全局唯一 printed_at TEXT, status TEXT NOT NULL DEFAULT valid -- valid / reprint / void ); CREATE INDEX idx_bill_period ON bill(period); CREATE INDEX idx_receipt_bill ON receipt(bill_id);幾個(gè)字段的取值不是隨手定的字段類型為什么這么設(shè)rent_cent/total_centINTEGER 分浮點(diǎn)乘 100 會(huì)出現(xiàn) 12999.999999 這類值取整方向一錯(cuò)就差一分prev_valueREAL 冗余上期讀數(shù)本該從上一行推導(dǎo)但跨年、換表、換租戶時(shí)推導(dǎo)會(huì)斷UNIQUE(room_id, period)約束防止重復(fù)算費(fèi)時(shí)插出兩張賬單月底對(duì)賬直接翻倍serialUNIQUE編號(hào)重復(fù)是收據(jù)類工具最致命的錯(cuò)靠約束兜底status文本枚舉作廢用狀態(tài)位表達(dá)不 DELETE留痕比省空間重要注意不要用是否已打印來控制收據(jù)能否重打用status加一張receipt_log表記流水。狀態(tài)位丟失可以重建流水丟了就真丟了。2.3 三個(gè)必須提前定死的約束編號(hào)唯一且不可復(fù)用。編號(hào)規(guī)則常見的是前綴 年月 四位流水的SD2024060001。生成時(shí)不要用SELECT MAX(serial)1那是并發(fā)下的經(jīng)典翻車點(diǎn)。要么單獨(dú)建一張counter(period, next_no)表在事務(wù)里自增要么直接依賴serial 的 UNIQUE 約束做插入失敗就重試三次。后者實(shí)現(xiàn)最省事import sqlite3, time def next_serial(conn, period: str, prefix: str SD) - str: 在事務(wù)里自增計(jì)數(shù)器SQLite 的寫鎖是庫級(jí)的天然串行 with conn: # with 塊自動(dòng) commit / rollback conn.execute(INSERT OR IGNORE INTO counter(period, next_no) VALUES (?, 1), (period,)) row conn.execute(SELECT next_no FROM counter WHERE period?, (period,)).fetchone() no row[0] conn.execute(UPDATE counter SET next_no? WHERE period?, (no 1, period)) return f{prefix}{period.replace(-, )}{no:04d}這里的關(guān)鍵是把取號(hào)和占號(hào)放在同一個(gè)寫事務(wù)里中途崩潰會(huì)整體回滾不會(huì)出現(xiàn)號(hào)被吃掉的情況。如果業(yè)務(wù)允許跳號(hào)作廢的號(hào)保留空缺把next_no的自增和收據(jù)插入也放進(jìn)同一事務(wù)失敗就整筆重來。抄表記錄只追加。抄錯(cuò)了怎么辦插一條sourcecorrect的新記錄用read_at的時(shí)間戳排序取最新而不是 UPDATE 舊行。原因是月底對(duì)賬時(shí)經(jīng)常有人問這戶上個(gè)月到底抄的是多少改過的記錄回答不了這個(gè)問題。金額只存整數(shù)分。這條約束要從數(shù)據(jù)入口一直貫穿到打印中間任何一次float * 100都是隱患。取整方向統(tǒng)一用四舍五入到分不要一會(huì)兒int()截?cái)嘁粫?huì)兒round()。2.4 從舊 Excel 導(dǎo)歷史數(shù)據(jù)一次性的遷移腳本換工具最大的阻力從來不是功能是老數(shù)據(jù)搬不過去。房源表通常是最規(guī)整的一張先導(dǎo)它。import re, sqlite3 from decimal import Decimal from openpyxl import load_workbook def to_cent(v) - int: 任何輸入先轉(zhuǎn)字符串再進(jìn) Decimal繞開 float 的二進(jìn)制誤差 return int((Decimal(str(v)) * 100).quantize(Decimal(1))) def import_rooms(xlsx_path: str, db_path: str) - None: wb load_workbook(xlsx_path, data_onlyTrue) # data_only 取公式結(jié)果而不是公式文本 ws wb.active conn sqlite3.connect(db_path) ok skip 0 for row in ws.iter_rows(min_row2, values_onlyTrue): code, area, rent row[0], row[1], row[2] if not code or rent in (None, ): skip 1 continue # 去空格、統(tǒng)一大寫避免 A-302 / a302 / A 302 在庫里變成三個(gè)房間 code re.sub(r\s, , str(code)).upper() cur conn.execute( INSERT OR IGNORE INTO room(code, area, rent_cent) VALUES (?,?,?), (code, float(area or 0), to_cent(rent)), ) ok cur.rowcount conn.commit() conn.close() print(f導(dǎo)入 {ok} 條跳過 {skip} 條)data_onlyTrue這個(gè)參數(shù)容易被忽略不加的話單元格里如果是公式讀出來是B2*C2這種字符串Decimal直接拋異常。INSERT OR IGNORE配合code的 UNIQUE 約束讓腳本可以反復(fù)跑跑第二遍不會(huì)插重復(fù)行這對(duì)遷移期反復(fù)試錯(cuò)很友好。跑完一定要抽三條數(shù)據(jù)手動(dòng)核對(duì)租金金額尤其是表格里帶千分位逗號(hào)的寫法——1,200進(jìn)Decimal會(huì)直接報(bào)錯(cuò)寧可讓腳本炸掉也不要靜默跳過。3. 從抄表數(shù)字到應(yīng)收金額租金折算、階梯水電和金額大寫的寫法3.1 計(jì)費(fèi)規(guī)則的三種常見形態(tài)與邊界幾十套房源的計(jì)費(fèi)規(guī)則聽上去簡(jiǎn)單真落到代碼里邊界情況比規(guī)則本身多計(jì)費(fèi)項(xiàng)常見規(guī)則容易漏的邊界月租金固定金額按月收中途入住/退租按天折算大小月天數(shù)不同水費(fèi)本期讀數(shù)減上期讀數(shù)乘單價(jià)換表導(dǎo)致讀數(shù)為 0抄表跨月漏抄電費(fèi)階梯計(jì)價(jià)或單一單價(jià)階梯跨檔時(shí)的分段計(jì)算公攤電量按戶/按面積其他衛(wèi)生費(fèi)、車位、滯納金滯納金是否計(jì)入本金、是否參與下期滾動(dòng)按天折算這塊最容易扯皮。行業(yè)里兩種算法按當(dāng)月實(shí)際天數(shù)折算或者統(tǒng)一按 30 天折算。前者更公平但每個(gè)月的日租金都不一樣后者好算但二月會(huì)出現(xiàn)住滿 28 天交整月的爭(zhēng)議。我一般選按實(shí)際天數(shù)并在賬單備注里把起始日 / 天數(shù) / 當(dāng)月天數(shù)三個(gè)數(shù)字打出來收據(jù)上看得見爭(zhēng)議就少一半。3.2 用 Decimal 把錢算準(zhǔn)計(jì)費(fèi)函數(shù)的最小實(shí)現(xiàn)from decimal import Decimal, ROUND_HALF_UP CENT Decimal(0.01) def q(x: Decimal) - Decimal: 所有金額出口統(tǒng)一走這個(gè)函數(shù)保證取整方向一致 return x.quantize(CENT, roundingROUND_HALF_UP) def rent_for_partial_month(month_rent: Decimal, days_used: int, days_in_month: int) - Decimal: 中途入住/退租的租金折算按當(dāng)月實(shí)際天數(shù) if days_used 0: return Decimal(0.00) if days_used days_in_month: return q(month_rent) # 住滿就按整月不做除法規(guī)避 1/31 的無限小數(shù) return q(month_rent * Decimal(days_used) / Decimal(days_in_month)) def tiered_fee(usage: Decimal, tiers): 階梯計(jì)價(jià)tiers [(檔位上限, 單價(jià)), ...]最后一檔上限寫 None fee, lower Decimal(0), Decimal(0) for cap, price in tiers: if usage lower: break upper Decimal(str(cap)) if cap is not None else usage seg min(usage, upper) - lower fee seg * Decimal(str(price)) lower upper return q(fee)三個(gè)函數(shù)各有各的用意。q()是唯一的取整出口把ROUND_HALF_UP收在一處比散落在十幾個(gè)地方各寫一遍要安全——只要有一處用了默認(rèn)的銀行家舍入就會(huì)出現(xiàn)這戶差一分、那戶多一分的玄學(xué)賬。rent_for_partial_month()里那個(gè)days_used days_in_month的短路分支是有意加的住滿整月卻走除法1200 * 31 / 31在某些精度設(shè)置下不一定回到 1200.00多一次除法就多一次風(fēng)險(xiǎn)。tiered_fee()用min(usage, upper) - lower計(jì)算每檔內(nèi)的用電量而不是預(yù)先判斷落在第幾檔好處是檔位數(shù)可以隨便改改配置不改代碼。單價(jià)參數(shù)建議放在一張price_config(period, kind, tiers_json)表里按賬期存快照。電價(jià)調(diào)整是常事如果只存一份當(dāng)前單價(jià)去年的賬單重算時(shí)會(huì)被新價(jià)覆蓋對(duì)賬就再也對(duì)不上了。3.3 金額大寫收據(jù)上最容易被挑錯(cuò)的一欄收據(jù)上數(shù)字金額和大寫金額不一致是最沒面子的一種錯(cuò)。中文大寫的規(guī)則不難難在零的處理1005是壹仟零伍元整1000005是壹佰萬零伍元整10是壹拾元整而不是拾元整。DIGITS 零壹貳叁肆伍陸柒捌玖 UNITS [, 拾, 佰, 仟] GROUPS [, 萬, 億] def _four(n: int) - str: 0-9999 轉(zhuǎn)大寫內(nèi)部函數(shù)不處理組間的零 s, pending_zero , False for i, ch in enumerate(str(n).zfill(4)): d, pos int(ch), 3 - i if d 0: pending_zero True else: if pending_zero and s: s 零 s DIGITS[d] UNITS[pos] pending_zero False return s def to_rmb_upper(cent: int) - str: 整數(shù)分 - 中文大寫如 100500 - 壹仟零伍元整 if cent 0: return 負(fù) to_rmb_upper(-cent) yuan, jiao, fen cent // 100, cent // 10 % 10, cent % 10 if yuan 0 and jiao 0 and fen 0: return 零元整 out if yuan: groups, y [], yuan while y 0: groups.append(y % 10000) y // 10000 for idx in range(len(groups) - 1, -1, -1): g groups[idx] if g 0: if out and not out.endswith(零): out 零 # 組內(nèi)全零如 100000005 中間的億后零 continue if out and g 1000 and not out.endswith(零): out 零 # 高位組與低位組之間的零如 壹佰萬零伍 out _four(g) GROUPS[idx] out out.rstrip(零) 元 if jiao 0 and fen 0: out 整 else: if jiao: out DIGITS[jiao] 角 elif yuan: out 零 # 如 100.05 - 壹佰元零伍分 if fen: out DIGITS[fen] 分 return out拿到手先跑一組邊界用例別信看著差不多輸入分期望輸出考察點(diǎn)0零元整全零1000壹拾元整十位不寫拾元100500壹仟零伍元整中間單個(gè)零100000500壹佰萬零伍元整跨組補(bǔ)零10005壹佰元零伍分角位為零、分位非零123456壹仟貳佰叁拾肆元伍角陸分完整形態(tài)提示大寫函數(shù)別在打印時(shí)才調(diào)用算完賬就存進(jìn)bill.total_upper字段。收據(jù)、對(duì)賬單、導(dǎo)出表格三處如果各調(diào)一次改一次規(guī)則就有三處不同步。3.4 寫庫前的一致性校驗(yàn)賬單落庫前的最后一道門是幾條assertdef check_bill(b) - None: parts b[rent_cent] b[water_cent] b[elec_cent] b[other_cent] assert parts b[total_cent], f分項(xiàng)之和 {parts} ! 總額 {b[total_cent]} assert b[total_cent] 0, 出現(xiàn)負(fù)數(shù)總額檢查是否把退款算進(jìn)了本期 assert to_rmb_upper(b[total_cent]) b[total_upper], 大寫與數(shù)字不一致這類斷言上線時(shí)看著多余出過一次事就知道值。有個(gè)房間因?yàn)樯掀谧x數(shù)錄成了 99999本期讀數(shù) 1234用量算成負(fù)數(shù)賬單總額直接變成負(fù)的收據(jù)上打出-XXX 元。數(shù)值校驗(yàn)一分鐘能寫完事后追查要半天。4. 套打與批量出票坐標(biāo)校準(zhǔn)、票據(jù)打印機(jī)和 PDF 留底4.1 收據(jù)模板的三種落地方式和取舍方式套打精度批量速度維護(hù)成本適合場(chǎng)景Word/Excel 郵件合并中靠表格邊距慢幾十張就卡低人人會(huì)改一次性出票套數(shù)少HTML 瀏覽器打印低受瀏覽器縮放影響中中屏幕預(yù)覽為主A4 普通紙代碼生成 PDF高坐標(biāo)可控到 0.1mm快中改動(dòng)要發(fā)版兩聯(lián)針式票據(jù)、需要留底走兩聯(lián)針式票據(jù)紙的基本只有第三條路。瀏覽器打印的邊距、縮放、頁眉頁腳三個(gè)變量疊在一起同一份 HTML 在兩臺(tái)機(jī)器上能打出兩種結(jié)果校準(zhǔn)一次管不了多久。生成 PDF 的好處是所見即所得——你看到的 PDF 坐標(biāo)就是打印機(jī)上紙的位置偏差只來自打印機(jī)本身的機(jī)械誤差是個(gè)可測(cè)量的常量。4.2 用 reportlab 畫一張固定坐標(biāo)的收據(jù)from reportlab.pdfgen import canvas from reportlab.lib.pagesizes import mm from reportlab.pdfbase import pdfmetrics from reportlab.pdfbase.ttfonts import TTFont # 中文字體必須先注冊(cè)否則中文全變方塊這是最常見的第一次翻車 pdfmetrics.registerFont(TTFont(CN, /usr/share/fonts/truetype/noto/NotoSansSC-Regular.ttf)) PAPER (241 * mm, 140 * mm) # 兩聯(lián)票據(jù)紙單聯(lián)尺寸按實(shí)際紙張改 OX, OY 3.5 * mm, -1.2 * mm # 全局套打偏移正值向右/向上 def draw_receipt(path: str, r: dict) - None: c canvas.Canvas(path, pagesizePAPER) c.setFont(CN, 10.5) # 針式打印機(jī) 10.5pt 是最穩(wěn)的字號(hào)再小容易糊 W, H PAPER def t(x_mm, y_mm, s): c.drawString(x_mm * mm OX, H - y_mm * mm OY, s) # y 從頂部往下算便于對(duì)紙 t(18, 16, f收據(jù)號(hào){r[serial]}) t(150, 16, f日期{r[date]}) t(18, 30, f房間{r[room_code]}) t(90, 30, f租戶{r[tenant]}) t(18, 42, f房租{r[rent]:.2f}) t(90, 42, f水費(fèi){r[water]:.2f}{r[water_usage]}噸) t(18, 54, f電費(fèi){r[elec]:.2f}{r[elec_usage]}度) t(90, 54, f其他{r[other]:.2f}) t(18, 70, f合計(jì){r[total]:.2f} 元) t(18, 86, f大寫{r[total_upper]}) t(150, 100, 收款人__________) c.showPage() c.save()t()這個(gè)包裝函數(shù)是為了讓坐標(biāo)可讀——直接寫H - 30*mm的話調(diào)一次位置就要在腦子里做一次減法。OY取負(fù)值是因?yàn)獒樖酱蛴C(jī)的進(jìn)紙定位通常比 PDF 原點(diǎn)偏上試出來是負(fù)的就寫負(fù)的。字號(hào)釘在 10.5pt 是踩出來的針式打印機(jī)分辨率低9pt 以下漢字的橫畫會(huì)斷成虛線12pt 以上兩聯(lián)紙的行距放不下五行。4.3 批量出票編號(hào)、命名、失敗重試import csv, os, time, traceback def batch_output(bills, outdirout, retries2): os.makedirs(outdir, exist_okTrue) ok, fail [], [] for b in bills: fname f{b[serial]}_{b[room_code]}_{b[period]}.pdf path os.path.join(outdir, fname) for attempt in range(retries 1): try: draw_receipt(path, b) ok.append(path) break except Exception: if attempt retries: fail.append((b.get(room_code), b.get(serial), traceback.format_exc(limit2))) else: time.sleep(0.2) # 字體未加載完、磁盤瞬時(shí)占用都可能一次失敗 with open(print_fail.csv, w, newline, encodingutf-8-sig) as f: csv.writer(f).writerows([(room, serial, error)] fail) return ok, fail命名里帶serial是為了讓歸檔目錄按文件名排序就等于按開票順序排事后找一張票不用翻數(shù)據(jù)庫。utf-8-sig的 BOM 是給 Excel 看的否則失敗清單在 Windows 上打開全是亂碼。先生成 PDF 再統(tǒng)一送打印機(jī)而不是邊算邊打理由很實(shí)際批量出票時(shí)最怕打到第 17 張卡紙前面 16 張已經(jīng)吐出來了后面 20 張還在不在隊(duì)列里說不清。先生成、核對(duì)、再一次性打印卡紙了重打整批也不心疼。打印環(huán)節(jié)用系統(tǒng)命令行最省事# Linux / macOS批量送默認(rèn)打印機(jī)份數(shù) 1 for f in out/*.pdf; do lp -n 1 -o mediaCustom.241x140mm $f; done # Windows用默認(rèn)關(guān)聯(lián)程序打印注意引號(hào)處理帶空格的路徑 powershell -Command Get-ChildItem out\*.pdf | ForEach-Object { Start-Process -FilePath $_.FullName -Verb Print }mediaCustom.241x140mm這個(gè)參數(shù)不能省。紙張尺寸不顯式傳打印機(jī)會(huì)退回 A4 縮放內(nèi)容整體縮到 70%坐標(biāo)全亂。Windows 那邊-Verb Print走的是關(guān)聯(lián)程序打印完不關(guān)進(jìn)程幾百張會(huì)堆一堆后臺(tái)窗口批量超過 50 張建議還是走 PDF 閱讀器的命令行參數(shù)。4.4 打印偏移校準(zhǔn)三張測(cè)試頁定坐標(biāo)校準(zhǔn)是個(gè)純體力活但有固定套路把OX/OY歸零用同一份模板打一張只有邊框和十字線的校準(zhǔn)頁。用鋼尺量四條邊到紙張邊緣的實(shí)際距離和設(shè)計(jì)值相減得到上下左右的偏差。取上下偏差的均值填OY左右偏差的均值填OX。注意 PDF 的 Y 軸向上為正所以內(nèi)容整體偏上意味著要往負(fù)方向調(diào)。再打一張確認(rèn)四個(gè)角的誤差控制在 ±0.5mm 以內(nèi)就算過。把這組值寫進(jìn)配置文件別寫死在代碼里——換一臺(tái)打印機(jī)就得重新校一次。打印機(jī)側(cè)設(shè)置建議值說明紙張尺寸自定義 241×140mm不要用 A4 縮放縮放比例100% / 實(shí)際大小驅(qū)動(dòng)里適應(yīng)頁面必須關(guān)掉邊距全部 0由 PDF 內(nèi)部坐標(biāo)控制打印質(zhì)量草稿或普通高質(zhì)量模式進(jìn)紙速度變化會(huì)導(dǎo)致縱向漂移注意同一份 PDF 在兩臺(tái)同型號(hào)打印機(jī)上也可能有 1mm 差異屬于機(jī)械公差。真要做到零誤差只能一臺(tái)機(jī)器一套配置按打印機(jī)名稱存偏移參數(shù)。5. 避坑與排查五類錯(cuò)票現(xiàn)場(chǎng)的現(xiàn)象、成因和處置5.1 解壓即用的目錄選錯(cuò)程序起來就報(bào)錯(cuò)現(xiàn)象雙擊啟動(dòng)后提示找不到模板文件或數(shù)據(jù)庫或者干脆閃退同一份程序在別人電腦上正常。原因這類免安裝工具默認(rèn)按相對(duì)路徑找template/和data.db一旦把整個(gè)文件夾丟到C:\Program Files或者桌面某個(gè)帶中文和空格的路徑下寫權(quán)限被系統(tǒng)收走或者路徑解析出問題。更隱蔽的是從壓縮包里直接雙擊運(yùn)行程序?qū)嶋H在臨時(shí)目錄里展開退出就沒了。解決固定解壓到D:\ReceiptTool\這種純英文無空格的短路徑先完整解壓再運(yùn)行。如果必須放共享盤只讀運(yùn)行可以寫數(shù)據(jù)庫不行單文件數(shù)據(jù)庫在網(wǎng)絡(luò)盤上的鎖機(jī)制不可靠。5.2 收據(jù)號(hào)重復(fù)或者整段跳號(hào)現(xiàn)象兩戶拿到同一個(gè)收據(jù)號(hào)或者打印中途崩潰重新打開后編號(hào)從 0050 直接跳到 0100。原因重復(fù)多半是取號(hào)用了MAX(serial)1且沒有事務(wù)保護(hù)兩個(gè)人同時(shí)開單讀到同一個(gè)最大值。跳號(hào)則是把占號(hào)寫成了預(yù)分配一批——啟動(dòng)時(shí)先取 50 個(gè)號(hào)放內(nèi)存崩潰后這 50 個(gè)號(hào)就丟了。解決取號(hào)必須和插入收據(jù)在同一個(gè)事務(wù)里靠 UNIQUE 約束兜底沖突就重試絕不預(yù)分配號(hào)段。已經(jīng)跳號(hào)的歷史數(shù)據(jù)不要手工補(bǔ)在收據(jù)表里插一條statusvoid的占位記錄說明原因比改歷史安全。5.3 數(shù)字和大寫差一分錢現(xiàn)象收據(jù)上合計(jì) 1234.56大寫卻是壹仟貳佰叁拾肆元伍角柒分。原因金額在中間環(huán)節(jié)被取整了兩次。比如水費(fèi)先round(x, 2)存成浮點(diǎn)出票時(shí)又格式化一次兩次舍入方向不一致或者大寫是由浮點(diǎn)金額直接乘 100 再轉(zhuǎn)整數(shù)1234.56 * 100得到123455.99999999999int()截?cái)喑?123455。解決全鏈路只保留整數(shù)分浮點(diǎn)只在最外層格式化輸出時(shí)出現(xiàn)。大寫函數(shù)只接受 int 類型的分?jǐn)?shù)值傳 float 進(jìn)來自動(dòng)拋異常逼著調(diào)用方在入口就把類型理順。5.4 換一臺(tái)電腦套打位置整體偏現(xiàn)象同一份 PDF在辦公室那臺(tái)針式打印機(jī)上正正好好搬到另一臺(tái)機(jī)器打出來整體偏下 4mm最后一行壓到撕線。原因打印機(jī)驅(qū)動(dòng)里紙張定義不一致或者適應(yīng)頁面沒關(guān)內(nèi)容被縮放了 2% 到 5%。也有可能是兩臺(tái)機(jī)器的紙張裝訂位置本來就差幾毫米。解決偏移量存配置文件按打印機(jī)名做 key第一次在新機(jī)器上跑一遍 4.4 的校準(zhǔn)流程。同時(shí)把驅(qū)動(dòng)的紙張尺寸、縮放、邊距三項(xiàng)截圖存檔換機(jī)器時(shí)逐項(xiàng)比對(duì)。5.5 單文件數(shù)據(jù)庫在共享盤上損壞現(xiàn)象某天打開程序提示database disk image is malformed或者賬單里憑空多出半條記錄。原因多個(gè)客戶端通過共享盤同時(shí)打開同一個(gè) SQLite 文件寫鎖在網(wǎng)絡(luò)文件系統(tǒng)上不生效兩個(gè)進(jìn)程同時(shí)寫頁文件結(jié)構(gòu)就爛了。解決單文件數(shù)據(jù)庫只允許單機(jī)單進(jìn)程訪問。多人開單的需求要么改成局域網(wǎng)內(nèi)跑一個(gè)服務(wù)端哪怕是個(gè)幾十行的 HTTP 接口要么按人分庫、月底合并。日常備份用VACUUM INTO backup.db而不是直接拷文件拷貝過程中有寫入的話拷出來的備份本身就是壞的。6. 出票前的驗(yàn)收用固定樣例集把錯(cuò)票攔在打印機(jī)之外真正讓我少賠笑臉的不是打印代碼寫得多漂亮而是一套固定樣例集。做法很土造 12 個(gè)房間覆蓋住滿整月、月中入住、月中退租、零用水、階梯跨檔、有上期欠費(fèi)、其他費(fèi)用為負(fù)退押金這七種情況賬期固定成三個(gè)月。每次改完計(jì)費(fèi)或模板先跑這批樣例把生成的 PDF 和上一次的逐字段比對(duì)再把下面這條 SQL 跑一遍。-- 三表閉合校驗(yàn)賬單總額 - 已開票收據(jù)總額 應(yīng)當(dāng)?shù)扔谖闯銎苯痤~不為 0 就是有孤兒數(shù)據(jù) SELECT b.period, SUM(b.total_cent) AS bill_total, SUM(CASE WHEN r.status valid THEN b.total_cent END) AS receipt_total, SUM(b.total_cent) - SUM(CASE WHEN r.statusvalid THEN b.total_cent END) AS diff, COUNT(*) AS bill_cnt FROM bill b LEFT JOIN receipt r ON r.bill_id b.id WHERE b.status void GROUP BY b.period HAVING diff 0;diff不為零有兩種解釋賬單開了沒收據(jù)正常還沒送出去或者收據(jù)掛在了不存在的賬單上異常外鍵被繞過寫進(jìn)去的。所以這條 SQL 的正確用法不是必須為零而是每個(gè)賬期的 diff 必須等于該期statusopen的賬單總額兩個(gè)數(shù)一對(duì)照異常立刻現(xiàn)形。驗(yàn)收清單我壓成了五行每次發(fā)版對(duì)著走一遍檢查項(xiàng)通過標(biāo)準(zhǔn)大寫金額12 組樣例全對(duì)含零值和跨組補(bǔ)零分項(xiàng)合計(jì)每張賬單分項(xiàng)之和等于總額無負(fù)數(shù)異常收據(jù)編號(hào)連續(xù)不重復(fù)作廢號(hào)有占位記錄套打位置首行、末行、右邊界三處誤差 ≤0.5mm歸檔完整性每張有效收據(jù)都有對(duì)應(yīng) PDF文件名含編號(hào)歸檔那塊我吃過一次虧某月清理磁盤時(shí)按修改時(shí)間刪了一批舊PDF結(jié)果里面有 6 張是補(bǔ)打過的收據(jù)編號(hào)對(duì)不上只能憑記憶重開。后來改成按賬期/編號(hào).pdf分層存每月出一次sha256sum清單和賬單表一起打包誰動(dòng)過文件一查就知道。我現(xiàn)在的習(xí)慣是任何跟金額、編號(hào)、坐標(biāo)相關(guān)的改動(dòng)先跑樣例集再看對(duì)賬 SQL最后才允許碰打印機(jī)。這三步順序顛倒過一次直接打廢了兩聯(lián)紙一沓重開還得挨個(gè)解釋。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取