萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Python Tkinter 實戰:構建功能完整的記事本應用

專案目標

從零構建一個具備**新建、打開、保存、另存為、撤銷/重做、查找/替換、行號顯示、狀態欄**的純 Tkinter 記事本,代碼結構清晰,易於擴展語法高亮、插件系統等進階功能。

架構設計


NotepadApp (tk.Tk)
├── MenuBar (tk.Menu)
│   ├── File: New, Open, Save, Save As, Exit
│   ├── Edit: Undo, Redo, Cut, Copy, Paste, Find, Replace
│   └── View: Toggle Line Numbers, Status Bar
├── ToolBar (ttk.Frame) - 可選
├── EditorFrame (ttk.Frame)
│   ├── LineNumbers (tk.Canvas) - 左側行號
│   ├── TextArea (tk.Text) - 核心編輯區
│   └── Scrollbars (ttk.Scrollbar)
└── StatusBar (ttk.Label) - 行/列、編碼、修改標記

核心代碼(精簡版,含關鍵功能)


import tkinter as tk
from tkinter import ttk, filedialog, messagebox, simpledialog
import os

class LineNumbers(tk.Canvas):
    """行號畫布:同步 Text 內容滾動"""
    def __init__(self, text_widget, *args, **kwargs):
        super().__init__(*args, width=40, bg='#f0f0f0', highlightthickness=0, **kwargs)
        self.text = text_widget
        self.text.bind('<>', self._on_change)
        self.text.bind('', self._on_change)
        self.text.bind('', self._on_change)
        self.font = ("Consolas", 10)

    def _on_change(self, event=None):
        self.redraw()

    def redraw(self):
        self.delete("all")
        i = self.text.index("@0,0")
        while True:
            dline = self.text.dlineinfo(i)
            if not dline: break
            y = dline[1]
            linenum = str(i).split(".")[0]
            self.create_text(2, y, anchor="nw", text=linenum, font=self.font, fill="#666")
            i = self.text.index(f"{i}+1line")

class NotepadApp(tk.Tk):
    def __init__(self):
        super().__init__()
        self.title("PyNotepad - Untitled")
        self.geometry("900x600")
        self.protocol("WM_DELETE_WINDOW", self.on_close)

        self.current_file = None
        self.modified = False
        self.encoding = 'utf-8'

        self._build_ui()
        self._bind_shortcuts()
        self.new_file()

    def _build_ui(self):
        # Menu
        menubar = tk.Menu(self)
        self.config(menu=menubar)

        file_menu = tk.Menu(menubar, tearoff=0)
        file_menu.add_command(label="New      Ctrl+N", command=self.new_file)
        file_menu.add_command(label="Open...  Ctrl+O", command=self.open_file)
        file_menu.add_command(label="Save     Ctrl+S", command=self.save_file)
        file_menu.add_command(label="Save As...", command=self.save_as)
        file_menu.add_separator()
        file_menu.add_command(label="Exit", command=self.on_close)
        menubar.add_cascade(label="File", menu=file_menu)

        edit_menu = tk.Menu(menubar, tearoff=0)
        edit_menu.add_command(label="Undo  Ctrl+Z", command=lambda: self.text.edit_undo())
        edit_menu.add_command(label="Redo  Ctrl+Y", command=lambda: self.text.edit_redo())
        edit_menu.add_separator()
        edit_menu.add_command(label="Cut   Ctrl+X", command=lambda: self.text.event_generate("<>"))
        edit_menu.add_command(label="Copy  Ctrl+C", command=lambda: self.text.event_generate("<>"))
        edit_menu.add_command(label="Paste Ctrl+V", command=lambda: self.text.event_generate("<>"))
        edit_menu.add_separator()
        edit_menu.add_command(label="Find  Ctrl+F", command=self.find_dialog)
        edit_menu.add_command(label="Replace Ctrl+H", command=self.replace_dialog)
        menubar.add_cascade(label="Edit", menu=edit_menu)

        view_menu = tk.Menu(menubar, tearoff=0)
        self.show_linenums = tk.BooleanVar(value=True)
        view_menu.add_checkbutton(label="Line Numbers", variable=self.show_linenums, command=self.toggle_linenums)
        self.show_status = tk.BooleanVar(value=True)
        view_menu.add_checkbutton(label="Status Bar", variable=self.show_status, command=self.toggle_status)
        menubar.add_cascade(label="View", menu=view_menu)

        # Editor Area
        editor_frame = ttk.Frame(self)
        editor_frame.pack(fill=tk.BOTH, expand=True)

        self.linenums = LineNumbers(editor_frame)
        self.linenums.pack(side=tk.LEFT, fill=tk.Y)

        self.text = tk.Text(editor_frame, wrap=tk.NONE, undo=True, maxundo=-1,
                            font=("Consolas", 11), tabs=('4c',))
        self.text.pack(side=tk.LEFT, fill=tk.BOTH, expand=True)

        # Scrollbars
        vscroll = ttk.Scrollbar(editor_frame, orient=tk.VERTICAL, command=self.text.yview)
        vscroll.pack(side=tk.RIGHT, fill=tk.Y)
        self.text['yscrollcommand'] = vscroll.set

        hscroll = ttk.Scrollbar(self, orient=tk.HORIZONTAL, command=self.text.xview)
        hscroll.pack(fill=tk.X)
        self.text['xscrollcommand'] = hscroll.set

        # Status Bar
        self.status_var = tk.StringVar(value="Ln 1, Col 1  |  UTF-8  |  INS")
        self.status_bar = ttk.Label(self, textvariable=self.status_var, anchor=tk.W, relief=tk.SUNKEN)
        self.status_bar.pack(fill=tk.X, side=tk.BOTTOM)

        # Bind text changes
        self.text.bind('<>', self._on_modified)
        self.text.bind('', self._update_status)
        self.text.bind('', self._update_status)

    def _bind_shortcuts(self):
        self.bind_all("", lambda e: self.new_file())
        self.bind_all("", lambda e: self.open_file())
        self.bind_all("", lambda e: self.save_file())
        self.bind_all("", lambda e: self.save_as())
        self.bind_all("", lambda e: self.find_dialog())
        self.bind_all("", lambda e: self.replace_dialog())

    # ----- File Operations -----
    def new_file(self):
        if self.check_save():
            self.text.delete("1.0", tk.END)
            self.current_file = None
            self.modified = False
            self.update_title()

    def open_file(self):
        if self.check_save():
            path = filedialog.askopenfilename(filetypes=[("Text Files", "*.txt"), ("All Files", "*.*")])
            if path:
                try:
                    with open(path, 'r', encoding=self.encoding) as f:
                        content = f.read()
                    self.text.delete("1.0", tk.END)
                    self.text.insert("1.0", content)
                    self.current_file = path
                    self.modified = False
                    self.update_title()
                except Exception as e:
                    messagebox.showerror("Error", f"Cannot open file:\n{e}")

    def save_file(self):
        if self.current_file:
            self._write_file(self.current_file)
        else:
            self.save_as()

    def save_as(self):
        path = filedialog.asksaveasfilename(defaultextension=".txt",
                                            filetypes=[("Text Files", "*.txt"), ("All Files", "*.*")])
        if path:
            self._write_file(path)

    def _write_file(self, path):
        try:
            with open(path, 'w', encoding=self.encoding) as f:
                f.write(self.text.get("1.0", "end-1c"))
            self.current_file = path
            self.modified = False
            self.update_title()
            return True
        except Exception as e:
            messagebox.showerror("Error", f"Cannot save file:\n{e}")
            return False

    def check_save(self) -> bool:
        if not self.modified: return True
        resp = messagebox.askyesnocancel("Unsaved Changes", "Save changes to current file?")
        if resp is None: return False  # Cancel
        if resp: return self.save_file()
        return True

    # ----- Find / Replace -----
    def find_dialog(self):
        FindReplaceDialog(self, self.text, replace=False)

    def replace_dialog(self):
        FindReplaceDialog(self, self.text, replace=True)

    # ----- UI Helpers -----
    def update_title(self):
        name = os.path.basename(self.current_file) if self.current_file else "Untitled"
        mark = "*" if self.modified else ""
        self.title(f"PyNotepad - {name}{mark}")

    def _on_modified(self, event=None):
        if self.text.edit_modified():
            self.modified = True
            self.update_title()
            self.text.edit_modified(False)

    def _update_status(self, event=None):
        idx = self.text.index(tk.INSERT)
        line, col = idx.split('.')
        self.status_var.set(f"Ln {line}, Col {int(col)+1}  |  {self.encoding.upper()}  |  {'INS' if not self.text.cget('overstrike') else 'OVR'}")

    def toggle_linenums(self):
        if self.show_linenums.get():
            self.linenums.pack(side=tk.LEFT, fill=tk.Y)
        else:
            self.linenums.pack_forget()

    def toggle_status(self):
        if self.show_status.get():
            self.status_bar.pack(fill=tk.X, side=tk.BOTTOM)
        else:
            self.status_bar.pack_forget()

    def on_close(self):
        if self.check_save():
            self.destroy()

class FindReplaceDialog(tk.Toplevel):
    def __init__(self, parent, text_widget, replace=False):
        super().__init__(parent)
        self.text = text_widget
        self.replace = replace
        self.title("Replace" if replace else "Find")
        self.geometry("350x120")
        self.resizable(False, False)
        self.transient(parent)
        self.grab_set()

        ttk.Label(self, text="Find:").grid(row=0, column=0, padx=5, pady=5, sticky=tk.W)
        self.find_var = tk.StringVar()
        ttk.Entry(self, textvariable=self.find_var, width=30).grid(row=0, column=1, padx=5, pady=5)
        self.find_var.trace_add("write", lambda *_: self.highlight())

        if replace:
            ttk.Label(self, text="Replace:").grid(row=1, column=0, padx=5, pady=5, sticky=tk.W)
            self.repl_var = tk.StringVar()
            ttk.Entry(self, textvariable=self.repl_var, width=30).grid(row=1, column=1, padx=5, pady=5)

        btn_frame = ttk.Frame(self)
        btn_frame.grid(row=2, column=0, columnspan=2, pady=10)
        ttk.Button(btn_frame, text="Find Next", command=self.find_next).pack(side=tk.LEFT, padx=5)
        if replace:
            ttk.Button(btn_frame, text="Replace", command=self.replace_one).pack(side=tk.LEFT, padx=5)
            ttk.Button(btn_frame, text="Replace All", command=self.replace_all).pack(side=tk.LEFT, padx=5)
        ttk.Button(btn_frame, text="Close", command=self.destroy).pack(side=tk.LEFT, padx=5)

        self.find_var.set(self.text.selection_get() if self.text.tag_ranges(tk.SEL) else "")
        self.find_entry = self.nametowidget(self.find_var._name) if False else None  # placeholder
        self.after(50, lambda: self.nametowidget(self.find_var._name).focus_set() if hasattr(self.find_var, '_name') else None)

    def highlight(self):
        self.text.tag_remove("search", "1.0", tk.END)
        needle = self.find_var.get()
        if not needle: return
        start = "1.0"
        while True:
            pos = self.text.search(needle, start, tk.END, nocase=True)
            if not pos: break
            end = f"{pos}+{len(needle)}c"
            self.text.tag_add("search", pos, end)
            start = end
        self.text.tag_config("search", background="yellow", foreground="black")

    def find_next(self):
        needle = self.find_var.get()
        if not needle: return
        start = self.text.index(tk.INSERT)
        pos = self.text.search(needle, start, tk.END, nocase=True)
        if not pos:
            pos = self.text.search(needle, "1.0", tk.END, nocase=True)
        if pos:
            end = f"{pos}+{len(needle)}c"
            self.text.tag_remove("sel", "1.0", tk.END)
            self.text.tag_add("sel", pos, end)
            self.text.mark_set(tk.INSERT, end)
            self.text.see(pos)

    def replace_one(self):
        if not self.text.tag_ranges(tk.SEL): return
        self.text.delete(tk.SEL_FIRST, tk.SEL_LAST)
        self.text.insert(tk.INSERT, self.repl_var.get())
        self.find_next()

    def replace_all(self):
        needle = self.find_var.get()
        repl = self.repl_var.get()
        if not needle: return
        count = 0
        start = "1.0"
        while True:
            pos = self.text.search(needle, start, tk.END, nocase=True)
            if not pos: break
            end = f"{pos}+{len(needle)}c"
            self.text.delete(pos, end)
            self.text.insert(pos, repl)
            start = f"{pos}+{len(repl)}c"
            count += 1
        messagebox.showinfo("Replace All", f"Replaced {count} occurrences")

if __name__ == "__main__":
    app = NotepadApp()
    app.mainloop()

關鍵技術點解析

  1. 行號同步:Canvas 繪製行號,監聽 <>, , 事件重繪,dlineinfo 獲取行像素坐標。
  2. 撤銷/重做:Text(undo=True, maxundo=-1) 啟用無限撤銷棧,edit_undo/redo、event_generate("<>") 等虛擬事件。
  3. 修改狀態追蹤:<> 事件 + edit_modified() 重置標誌。
  4. 查找高亮:tag_add + tag_config 實現非侵入式高亮。
  5. 編碼處理:統一 UTF-8,實際專案可加入編碼檢測(chardet)與轉換。

擴展方向

  • 語法高亮:pygments + 定時器增量解析,應用 tag 上色。
  • 多標籤頁:ttk.Notebook 管理多個 EditorFrame。
  • 外掛系統:動態載入實現 INotepadPlugin 介面的模組。
  • 自動保存/會話恢復:定時寫入臨時文件,啟動時恢復。

總結

本文實現了一個功能完整、代碼結構清晰的 Tkinter 記事本,涵蓋文件操作、編輯器核心、UI 佈局、鍵盤快捷鍵、查找替換、行號同步、狀態欄等實戰技能。代碼約 350 行,無第三方依賴,可直接運行並作為擴展基礎。

copyright © 萬盛學電腦網 all rights reserved