來源：https://blog.csdn.net/2403_87969572/article/details/156458290

抓取時間（ISO本地）：2026-05-18 05:17:27

---

前言

作為學生，想必大家都有過被海量手寫實驗報告、課程作業支配的痛苦。要花費大量時間一筆一劃地抄寫到紙質文件中再進行掃描成pdf提交，不僅耗時耗力，手寫的字跡還可能參差不齊，影響作業美觀度。

為了偷懶，博主開發了一款基於python的PDF手寫模擬器，它能夠模擬真實手寫筆跡，將電腦上的文字批次填充到 PDF 指定區域，支援中文/英文分開配置、手寫擾動效果自定義、配置模版複用等功能，生成的效果高度貼近真實手寫，幫你徹底告別手動抄寫的煩惱。首先來個介面以及效果預覽：

程式碼已經開源在Github：https://github.com/ChenAI-TGF/PDF_HandWrite
歡迎大家下載，如果覺得有用的話可以給我點個Star，萬分感謝！！
如果登不上Github的話也歡迎直接私信博主要程式碼

流程思路總覽

這款 PDF 手寫模擬器的整體運作流程可以分為「使用者操作流程」和「技術實現流程」兩層，清晰易懂：

1. 使用者操作流程（簡單易上手）

1. 開啟目標 PDF：選擇需要填寫的實驗報告、作業等 PDF 檔案；
   
   
2. 框選填寫區域：在 PDF 預覽介面拖動滑鼠，框選出需要插入文字的區域（紅色矩形標記）；
   
3. 配置手寫引數：分別在中文、英文/數字選項卡中調整字型、大小、顏色、擾動效果等引數；
   
4. 輸入並預覽文字：在右側文字框輸入需要填寫的內容，開啟「實時預覽」檢視手寫效果；
   
   
5. 不滿意可實時調整引數
   
6. 確認並儲存：效果滿意後確認應用筆跡，支援撤銷、擦除錯誤內容，也可儲存當前配置為模版，最後匯出填寫完成的 PDF。

2. 技術實現流程（分層協作）

1. UI 互動層：基於 tkinter 搭建視覺化介面，提供按鈕、選項卡、文字框等互動元件，接收使用者操作；
2. 引數配置層：管理中文/英文手寫引數，支援配置儲存（JSON）與載入，實現模版複用；
3. PDF 操作層：基於 PyMuPDF 實現 PDF 的讀取、頁面渲染、文字插入、擦除、儲存等核心操作；
4. 手寫渲染層：核心邏輯層，實現文字排版、語言區分、手寫擾動效果生成，最終將模擬手寫文字插入 PDF。

┌─────────────────────┐
│  UI互動層（tkinter） │  # 視覺化互動，接收操作
└─────────────┬───────┘
              ▼
┌─────────────────────┐
│  引數配置層（JSON）  │  # 引數管理，模版複用
└─────────────┬───────┘
              ▼
┌─────────────────────┐
│ PDF操作層（PyMuPDF） │  # PDF核心操作（讀寫/儲存等）
└─────────────┬───────┘
              ▼
┌─────────────────────┐
│  手寫渲染層（核心）  │  # 手寫效果生成，文字插入
└─────────────────────┘

涉及的具體技術

這款工具基於 Python 生態的常用庫開發，技術棧輕量化且實用性強，核心涉及以下技術：

1. tkinter：Python 內建 GUI 庫，無需額外安裝，負責搭建整個應用的視覺化介面，實現按鈕點選、引數調整、文字輸入、PDF 預覽等互動功能；
2. PyMuPDF（fitz）：核心 PDF 處理庫，提供高效的 PDF 讀取、寫入、頁面渲染、文字插入、紅act標註（擦除功能）等介面，是實現 PDF 編輯的核心依賴；
3. Pillow（PIL）：影象處理庫，將 PyMuPDF 渲染出的 PDF 頁面畫素資料，轉換成 tkinter 畫布可顯示的影象格式，實現 PDF 頁面的視覺化預覽；
4. JSON：輕量級資料格式，用於儲存使用者配置的手寫引數模版（字型、大小、擾動值等），方便後續直接複用，無需重複調整；
5. Python 隨機數與數學計算：實現手寫效果的「不規則擾動」，模擬真實手寫的位置偏移、大小波動、行傾斜等特性；
6. TTF 字型支援：讀取自定義 TrueType 字型檔案，支援切換不同手寫風格字型，適配不同使用者的手寫習慣。

最終效果演示

程式碼原理簡單講解（手寫字型生成 + 擾動效果）

我們重點講解核心功能 —— 手寫字型生成與擾動效果的實現，忽略 UI 搭建等輔助程式碼，聚焦核心邏輯：

一、 手寫字型生成（文字插入 PDF 核心）

這部分的核心是將文字按規則排版後，插入到 PDF 指定區域，關鍵步驟如下：

1. 文字與區域預處理
   首先獲取文字框中的輸入文字，按換行符 \n 分割成多行，同時將使用者框選的預覽區域座標（帶縮放比例）轉換為 PDF 實際座標（除以縮放係數 self.zoom），得到真實的填寫範圍 (x1, y1, x2, y2)。

   # 讀取輸入文字並分割行
   text = self.text_editor.get("1.0", tk.END).strip("\n")
   lines = text.split('\n')
   # 轉換為 PDF 實際座標（去除預覽縮放影響）
   x1, y1 = min(self.start_x, self.end_x)/self.zoom, min(self.start_y, self.end_y)/self.zoom
   x2, y2 = max(self.start_x, self.end_x)/self.zoom, max(self.start_y, self.end_y)/self.zoom
   

2. 語言區分與引數匹配
   透過 is_chinese 函式判斷單個字元是中文還是英文/數字，分別匹配對應的配置引數（中文/英文獨立的字型、大小、字距等），確保不同語言的手寫效果適配合理。

   # 判斷是否為中文（含中文標點）
   def is_chinese(self, char):
       if '\u4e00' <= char <= '\u9fff': return True
       if char in "。，、？！：；“”‘’（）《》【】": return True
       return False
   
   # 遍歷字元時匹配對應語言引數
   lang = 'zh' if self.is_chinese(char) else 'en'
   p = self.params[lang]  # 獲取對應語言的配置引數
   

3. PDF 文字插入核心 API
   使用 PyMuPDF 的 page.insert_text 方法實現文字插入，這是手寫字型生成的關鍵，核心引數說明如下：

   • fitz.Point(final_x, final_y)：文字的實際插入座標（經排版和擾動調整後）；
   • char：要插入的單個字元（逐字元插入實現精細排版）；
   • fontsize：字元的實際大小（帶大小抖動）；
   • fontfile：TTF 手寫字型檔案路徑，決定字型風格；
   • color：文字顏色（預設純黑，支援使用者自定義）；
   • morph：變換矩陣，實現字元旋轉效果（疊加行傾斜與字元旋轉抖動）。

4. 行與字元排版
   按行遍歷文字，逐字元計算插入座標，處理空格（單獨預留間距），當字元橫座標超出框選區域右側時自動換行，同時根據「行距引數」調整下一行的縱座標，確保文字排版規整且不超出框選範圍。

二、 擾動效果實現（模擬真實手寫不規則性）

這是工具的靈魂所在，透過「行級擾動」和「字元級擾動」兩層效果，徹底擺脫列印體的規整感，貼近真實手寫，對應程式碼中的配置引數：

1. 行級擾動（整行不規則性）
   針對每一行文字，新增整體的偏移和傾斜，模擬手寫時「行不直、略有偏移」的特點，對應三個引數：

   • 行左右平移（line_jitter_x）：隨機生成 -line_jitter_x ~ line_jitter_x 範圍內的偏移量 line_dx，使每行文字左右輕微晃動；
   • 行上下平移（line_jitter_y）：隨機生成 -line_jitter_y ~ line_jitter_y 範圍內的偏移量 line_dy，使行與行之間的間距略有差異；
   • 行整行傾斜（line_tilt）：隨機生成傾斜角度 line_angle_deg，轉換為弧度後，透過 tilt_y_offset = (curr_x - line_start_x) * math.tan(line_angle_rad) 計算每個字元的Y軸偏移，實現整行輕微傾斜。

   # 行級擾動引數計算
   line_dx = random.uniform(-p_line['line_jitter_x'].get(), p_line['line_jitter_x'].get())
   line_dy = random.uniform(-p_line['line_jitter_y'].get(), p_line['line_jitter_y'].get())
   line_angle_deg = random.uniform(-p_line['line_tilt'].get(), p_line['line_tilt'].get())
   line_angle_rad = math.radians(line_angle_deg)
   

2. 字元級擾動（單個字元不規則性）
   針對每個字元，新增位置、大小、旋轉的細微差異，模擬手寫時「每個字大小不一、略有晃動」的特點，對應三個引數：

   • 字位置抖動（jitter_pos）：隨機生成 (-jitter_pos ~ jitter_pos) 的X、Y偏移量，使字元脫離嚴格的水平對齊；
   • 字大小抖動（jitter_size）：在基礎字型大小上，隨機增減 (-jitter_size ~ jitter_size) 的數值，生成 char_jitter_fs，使字元大小略有差異；
   • 字旋轉抖動（jitter_rot）：隨機生成 (-jitter_rot ~ jitter_rot) 的旋轉角度，疊加行傾斜角度後，透過 morph 引數實現字元輕微旋轉。

   # 字元級擾動引數計算
   char_jitter_x = random.uniform(-p['jitter_pos'].get(), p['jitter_pos'].get())
   char_jitter_y = random.uniform(-p['jitter_pos'].get(), p['jitter_pos'].get())
   char_jitter_rot = random.uniform(-p['jitter_rot'].get(), p['jitter_rot'].get())
   char_jitter_fs = f_size + random.uniform(-p['jitter_size'].get(), p['jitter_size'].get())
   

3. 隨機數控制（預覽穩定 + 實際隨機）
   為了保證實時預覽時效果穩定可調整，設定隨機數種子 random.seed(42) 固定擾動效果；實際應用筆跡時，不設定種子 random.seed()，生成隨機的擾動效果，讓每次生成的手寫風格略有差異，更貼近真實場景。

   if is_preview: random.seed(42)  # 預覽模式：固定隨機數，效果穩定
   else: random.seed()  # 實際生成：隨機種子，效果更真實
   

總結

這款 PDF 手寫模擬器完美解決了手寫作業、實驗報告的痛點，兼具「實用性」和「靈活性」：

1. 實用性拉滿：無需手動抄寫，一鍵生成手寫風格 PDF，節省大量時間和精力，生成效果高度貼近真實手寫；
2. 自定義性強：中文/英文獨立配置，支援字型、顏色、大小、字距行距調整，多層擾動引數可精細調控手寫風格；
3. 操作便捷：視覺化介面友好，支援實時預覽、撤銷、擦除、模版複用，零基礎使用者也能快速上手；
4. 技術輕量化：基於 Python 常用庫開發，無需複雜環境配置，程式碼可靈活修改擴充套件。

當然，這款工具還有最佳化空間，比如支援連筆效果、筆跡粗細變化、批次處理多個 PDF 等。如果大家有類似需求，可以基於這份程式碼進行二次開發，適配自己的使用場景。希望這款工具能幫大家解放雙手，把更多時間投入到核心學習和研究中！

程式碼已經開源在Github：https://github.com/ChenAI-TGF/PDF_HandWrite
歡迎大家下載，如果覺得有用的話可以給我點個Star，萬分感謝！！
如果登不上Github的話也歡迎直接私信博主要程式碼