我要评论很多 python 初学者学完基础语法后，都会进入一个新的阶段：不只是想写命令行脚本，而是想做一个真正“能点按钮、能输入内容、能看到界面”的桌面程序。
这时候，tkinter 往往是最适合入门的 gui 库之一。
它是 python 标准库自带的图形界面工具包，不需要额外安装复杂环境，直接就能开始写窗口、按钮、输入框、列表、弹窗这些桌面应用里最常见的界面元素。
这篇文章不打算只讲几个零散控件，而是带你做一个完整的小项目：桌面待办事项应用。
你会通过这个演示程序学会：
- tkinter 是什么，适合做什么
- 如何创建窗口和运行 gui 程序
- 如何放置输入框、按钮、表格和状态栏
- 如何响应按钮点击和双击事件
- 如何把界面和数据组织成一个可维护的小程序
- tkinter 除了做教学 demo 之外，还能拿来做什么
学完之后，你至少能独立写出一个基础可用的 python 桌面工具。
1. tkinter 是什么
tkinter 是 python 标准库提供的 gui 编程接口，用来开发桌面图形界面应用。
简单理解，它能让你把原本只能在终端里运行的 python 程序，做成一个有窗口、有按钮、有输入框的桌面软件。
tkinter 常见的使用场景包括：
- 文件批量处理工具
- excel/csv 数据整理小工具
- 配置面板
- 内部办公辅助工具
- 学习 gui 编程基础
它最大的优势很直接：
- python 自带，安装门槛低
- api 相对直观，适合初学者
- 跨平台，可以在 windows、macos、linux 上运行
- 做中小型桌面工具足够实用
当然，它也不是万能的。如果你要做复杂商业软件、现代化程度很高的 ui、特别重的表格和图形交互，后面通常还会接触到 pyqt、pyside、wxpython 等方案。
但如果目标是先把 gui 的基本思路学会，tkinter 很合适。
2. 学 tkinter 之前，先理解 gui 程序在做什么
命令行程序通常是这样的：
- 运行脚本
- 输入内容
- 程序处理
- 输出结果
- 结束
而 gui 程序不一样。它通常会一直运行，等待用户操作：
- 点击按钮
- 输入文本
- 选择列表项
- 关闭窗口
所以 gui 编程最核心的变化是：程序不再是“一次执行完”，而是进入一个事件循环，持续响应用户动作。
这也是 tkinter 里 mainloop() 很重要的原因。
3. 先看一个最小可运行示例
先别急着看完整项目，先理解 tkinter 最基础的结构：
import tkinter as tk
from tkinter import ttk
root = tk.tk()
root.title("我的第一个 tkinter 窗口")
root.geometry("320x180")
ttk.label(root, text="hello tkinter").pack(pady=20)
ttk.button(root, text="关闭", command=root.destroy).pack()
root.mainloop()
这段代码里最关键的几件事是：
tk.tk()：创建主窗口title()：设置窗口标题geometry()：设置窗口大小label和button：创建界面控件pack()：把控件放到窗口里mainloop()：启动事件循环，让窗口持续响应用户操作
你可以把它理解成：窗口先创建出来，然后把控件放进去，最后让程序开始“监听交互”。
4. 这篇文章要做的演示程序是什么
我们不做太空泛的按钮示例，而是做一个更像真实工具的小程序：桌面待办事项应用。
功能包括：
- 输入任务内容
- 点击按钮添加任务
- 双击任务切换完成状态
- 删除当前选中任务
- 清空已完成任务
- 在底部显示总数、进行中、已完成统计
- 关闭窗口时自动保存数据，下次打开继续使用
这个例子非常适合 tkinter 入门，因为它覆盖了 gui 开发里最常见的几类需求：
- 文本输入
- 按钮点击
- 列表展示
- 事件绑定
- 状态刷新
- 简单数据持久化
5. 完整演示程序代码
下面这份代码可以直接运行。为了方便你本地练习，我也已经把它整理成单独文件：
tkinter_todo_demo.py
完整代码如下：
import json
from pathlib import path
import tkinter as tk
from tkinter import messagebox, ttk
data_file = path(__file__).with_name("tkinter_todo_tasks.json")
class todoapp:
def __init__(self, root: tk.tk) -> none:
self.root = root
self.root.title("tkinter 待办事项演示")
self.root.geometry("680x440")
self.root.minsize(560, 360)
self.tasks: list[dict[str, object]] = []
self.task_var = tk.stringvar()
self.status_var = tk.stringvar()
self._build_ui()
self._load_tasks()
self._refresh_tree()
self.root.protocol("wm_delete_window", self.on_close)
def _build_ui(self) -> none:
container = ttk.frame(self.root, padding=16)
container.pack(fill="both", expand=true)
header = ttk.label(
container,
text="待办事项桌面应用",
font=("microsoft yahei ui", 16, "bold"),
)
header.pack(anchor="w")
intro = ttk.label(
container,
text="输入任务后点击添加；双击任务可切换完成状态。",
)
intro.pack(anchor="w", pady=(6, 12))
input_row = ttk.frame(container)
input_row.pack(fill="x")
ttk.label(input_row, text="任务内容：").pack(side="left")
entry = ttk.entry(input_row, textvariable=self.task_var)
entry.pack(side="left", fill="x", expand=true, padx=(8, 8))
entry.bind("<return>", self.add_task)
entry.focus()
ttk.button(input_row, text="添加任务", command=self.add_task).pack(side="left")
button_row = ttk.frame(container)
button_row.pack(fill="x", pady=(12, 12))
ttk.button(button_row, text="删除选中", command=self.delete_selected_task).pack(
side="left"
)
ttk.button(button_row, text="清空已完成", command=self.clear_completed_tasks).pack(
side="left", padx=(8, 0)
)
ttk.button(button_row, text="全部标记未完成", command=self.reset_all_tasks).pack(
side="left", padx=(8, 0)
)
table_frame = ttk.frame(container)
table_frame.pack(fill="both", expand=true)
columns = ("status", "title")
self.tree = ttk.treeview(
table_frame,
columns=columns,
show="headings",
selectmode="browse",
)
self.tree.heading("status", text="状态")
self.tree.heading("title", text="任务")
self.tree.column("status", width=110, anchor="center")
self.tree.column("title", width=480, anchor="w")
self.tree.pack(side="left", fill="both", expand=true)
self.tree.bind("<double-1>", self.toggle_selected_task)
scrollbar = ttk.scrollbar(table_frame, orient="vertical", command=self.tree.yview)
scrollbar.pack(side="right", fill="y")
self.tree.configure(yscrollcommand=scrollbar.set)
status_bar = ttk.label(
container,
textvariable=self.status_var,
anchor="w",
relief="groove",
padding=(8, 6),
)
status_bar.pack(fill="x", pady=(12, 0))
def add_task(self, event=none) -> none:
title = self.task_var.get().strip()
if not title:
messagebox.showwarning("提示", "请输入任务内容后再添加。")
return
self.tasks.append({"title": title, "done": false})
self.task_var.set("")
self._refresh_tree()
def toggle_selected_task(self, event=none) -> none:
task_index = self._get_selected_index()
if task_index is none:
return
self.tasks[task_index]["done"] = not bool(self.tasks[task_index]["done"])
self._refresh_tree()
def delete_selected_task(self) -> none:
task_index = self._get_selected_index()
if task_index is none:
messagebox.showinfo("提示", "请先选中一条任务。")
return
title = str(self.tasks[task_index]["title"])
if not messagebox.askyesno("确认删除", f"确定删除任务：{title} 吗？"):
return
del self.tasks[task_index]
self._refresh_tree()
def clear_completed_tasks(self) -> none:
completed_count = sum(1 for task in self.tasks if task["done"])
if completed_count == 0:
messagebox.showinfo("提示", "当前没有已完成任务。")
return
self.tasks = [task for task in self.tasks if not task["done"]]
self._refresh_tree()
def reset_all_tasks(self) -> none:
if not self.tasks:
messagebox.showinfo("提示", "当前任务列表为空。")
return
for task in self.tasks:
task["done"] = false
self._refresh_tree()
def _get_selected_index(self) -> int | none:
selected = self.tree.selection()
if not selected:
return none
return int(selected[0])
def _refresh_tree(self) -> none:
self.tree.delete(*self.tree.get_children())
for index, task in enumerate(self.tasks):
status = "已完成" if task["done"] else "进行中"
self.tree.insert("", "end", iid=str(index), values=(status, task["title"]))
total = len(self.tasks)
done = sum(1 for task in self.tasks if task["done"])
pending = total - done
self.status_var.set(
f"任务总数：{total} 进行中：{pending} 已完成：{done}"
)
def _load_tasks(self) -> none:
if not data_file.exists():
self.tasks = [
{"title": "学习 tkinter 的窗口和控件", "done": false},
{"title": "完成一个桌面待办事项小工具", "done": true},
]
return
try:
self.tasks = json.loads(data_file.read_text(encoding="utf-8"))
except (json.jsondecodeerror, oserror):
self.tasks = []
def _save_tasks(self) -> none:
try:
data_file.write_text(
json.dumps(self.tasks, ensure_ascii=false, indent=2),
encoding="utf-8",
)
except oserror as exc:
messagebox.showerror("保存失败", f"无法写入任务数据：{exc}")
def on_close(self) -> none:
self._save_tasks()
self.root.destroy()
def main() -> none:
root = tk.tk()
app = todoapp(root)
root.mainloop()
if __name__ == "__main__":
main()
6. 运行这个程序
如果你的 python 环境正常，tkinter 一般已经自带。直接运行：
python tkinter_todo_demo.py
如果窗口正常弹出，就说明你已经跑通了一个完整的 gui 小应用。
7. 这个程序里，最值得新手先学会的几个点
7.1 主窗口是怎么创建的
root = tk.tk()
root.title("tkinter 待办事项演示")
root.geometry("680x440")
这几行决定了窗口对象本身。你以后做任何 tkinter 桌面应用，基本都要从这里开始。
7.2 为什么用了ttk
你会发现代码里同时导入了：
import tkinter as tk from tkinter import messagebox, ttk
其中：
tkinter提供基础 gui 能力ttk提供更现代一些的控件外观messagebox用来弹出提示框、确认框、错误框
实际开发里，很多人会优先用 ttk.button、ttk.label、ttk.entry 这些控件。
7.3stringvar是做什么的
self.task_var = tk.stringvar() self.status_var = tk.stringvar()
stringvar 是 tkinter 里很常用的变量绑定对象。
例如输入框：
entry = ttk.entry(input_row, textvariable=self.task_var)
这样输入框和 self.task_var 就绑定起来了。你可以通过：
self.task_var.get()
self.task_var.set("")
来读取或修改输入框内容。
这是一种很典型的 gui 编程方式：控件和状态不是完全分开的，变量对象负责把它们关联起来。
7.4 按钮点击是怎么响应的
ttk.button(input_row, text="添加任务", command=self.add_task)
这里的 command=self.add_task，就是把按钮点击事件绑定到了方法上。
当用户点击按钮时，tkinter 就会调用这个函数。
这正是 gui 编程最核心的概念之一：事件驱动。
7.5 为什么还绑定了回车和双击事件
entry.bind("<return>", self.add_task)
self.tree.bind("<double-1>", self.toggle_selected_task)
这两句分别表示：
- 在输入框里按回车，也可以添加任务
- 在表格里双击一行，可以切换任务完成状态
这一步会让你的程序明显更像一个真正能用的小工具，而不是只能机械点按钮的 demo。
7.6 表格列表为什么用treeview
很多新手一开始只知道 listbox，但 ttk.treeview 在桌面工具里更常见，因为它可以做多列表格展示。
比如这里我们定义了两列：
columns = ("status", "title")
然后分别设置列标题和宽度：
self.tree.heading("status", text="状态")
self.tree.heading("title", text="任务")
所以这个程序展示出来会更像传统桌面应用里的数据列表。
7.7 为什么要有_refresh_tree()
gui 程序一个特别重要的习惯是：数据变化后，要有明确的界面刷新逻辑。
在这个例子里：
- 添加任务后要刷新
- 删除任务后要刷新
- 切换完成状态后要刷新
- 加载初始数据后也要刷新
所以把这件事集中到 _refresh_tree() 里，是很好的组织方式。
这也是新手很值得尽早养成的代码习惯。
7.8 桌面应用如何保存数据
如果程序一关，所有任务都消失，那就不太像一个真正的桌面工具。
所以这个例子里用到了：
data_file = path(__file__).with_name("tkinter_todo_tasks.json")
关闭窗口时：
self.root.protocol("wm_delete_window", self.on_close)
在 on_close() 中调用 _save_tasks()，把任务列表保存为本地 json 文件。这样下次再打开程序，就还能继续看到之前的数据。
这个思路非常实用。很多入门级桌面工具，完全可以先用 json、csv、sqlite 这种轻量方式做本地持久化。
8. tkinter 还能做什么
很多人以为 tkinter 只能做几个按钮和输入框，其实它还能覆盖不少基础桌面工具需求。
例如：
- 表单录入工具
- 文件选择和批量处理工具
- 文本编辑小工具
- 数据查询面板
- 配置中心
- 简单绘图或 canvas 小程序
- 多窗口弹窗工具
tkinter 常见可配合的功能还有：
filedialog：选择文件和目录messagebox：提示、确认、错误弹窗menu：菜单栏canvas：绘图区域notebook：标签页布局progressbar：进度条
也就是说，tkinter 不只是“学习用”，它在很多中小型内部工具里完全能落地。
9. 新手学 tkinter 最容易踩的坑
9.1 忘了调用mainloop()
如果不调用它，窗口可能一闪而过，或者根本不会进入交互状态。
9.2 把所有逻辑都写在一大段脚本里
小 demo 还能忍，但稍微复杂一点就会难维护。像本文这样用一个类把窗口、数据和事件处理组织起来，会清晰很多。
9.3 数据更新了，但界面没刷新
这是 gui 初学者非常常见的问题。记住：修改 python 数据结构，不等于界面自动就会变。
你需要主动把变更同步到控件上。
9.4 只会pack()，不会布局拆分
pack() 很适合入门，但程序复杂后，你也会逐渐接触 grid() 和更细的布局控制。先学会用 frame 分区，会比把所有控件直接塞到根窗口里更重要。
10. 给想学 gui 开发同学的建议
如果你是第一次学 python gui，我建议按下面顺序练习：
- 先写一个只有标签和按钮的小窗口
- 再加输入框和变量绑定
- 再加列表或表格控件
- 再学弹窗、文件选择、菜单栏
- 再做一个完整的小工具，比如本文这个待办应用
- 最后再考虑打包、主题、复杂架构和更高级的 gui 框架
不要一上来就追求“界面要特别好看”。对新手来说，先理解事件驱动、状态更新和布局组织，比一开始追视觉效果更重要。
11. 总结
如果你想进入 python gui 开发，tkinter 是很值得认真学一遍的起点。
它的价值不在于“界面最炫”，而在于它可以让你以最低的环境成本，真正理解桌面应用是怎么运作的：
- 怎么创建窗口
- 怎么放控件
- 怎么响应事件
- 怎么更新界面
- 怎么保存数据
当你把这些事情跑通之后，再去学 pyqt、pyside 这类更复杂的 gui 框架，会轻松很多。
如果你现在刚好想开始练手，最直接的方式就是把本文里的 tkinter_todo_demo.py 运行起来，再自己继续加功能。比如：
- 添加截止日期
- 增加任务优先级
- 支持任务搜索
- 用 sqlite 保存数据
- 增加菜单栏和设置窗口
只要你能把一个小桌面工具真正做出来，gui 开发就不会再停留在“看过教程”的阶段。
以上就是python使用tkinter开发一个桌面待办事项应用的详细内容，更多关于python tkinter桌面待办事项应用的资料请关注代码网其它相关文章！
发表评论