Python Tkinter 入门指南：轻松创建图形界面应用

kayoon 收录于 Python

2025-05-01 约 3600 字预计阅读 8 分钟 - 次阅读

图形用户界面（GUI）让程序更加直观易用，而 Python 的 Tkinter 库正是进入 GUI 编程世界的绝佳起点。无论你是想为脚本添加简单界面，还是构建功能丰富的桌面应用，Tkinter 都能满足你的需求。

1. 什么是 Tkinter

Tkinter 是 Python 的标准 GUI 工具包，它基于 Tk GUI 工具集，提供了创建窗口、按钮、文本框等界面元素的简单方法。
Tkinter 最大的优势在于它是 Python 标准库的一部分，无需额外安装。
tkinter官方中文文档

2. 第一个 Tkinter 程序

让我们从一个简单的"Hello World"程序开始：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17


import tkinter as tk

# 创建主窗口
root = tk.Tk()
root.title("我的第一个 Tkinter 程序")
root.geometry("300x200")  # 设置窗口大小

# 创建标签
label = tk.Label(root, text="Hello, Tkinter!")
label.pack(pady=20)  # 将标签添加到窗口并设置上下边距

# 创建按钮
button = tk.Button(root, text="点击我", command=lambda: label.config(text="你点击了按钮!"))
button.pack(pady=10)

# 启动主循环
root.mainloop()

运行这段代码，你将看到一个带有文本和按钮的窗口。

3. 常用 Tkinter 组件

3.1 标签 (Label)

1
2


label = tk.Label(root, text="这是一个标签", font=("Arial", 14), fg="blue")
label.pack()

3.2 按钮 (Button)

1
2
3
4
5


def button_click():
    print("按钮被点击了!")

button = tk.Button(root, text="点击", command=button_click, bg="lightgreen")
button.pack()

3.3 输入框 (Entry)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


entry = tk.Entry(root, width=30)
entry.pack()

# 获取输入内容
def get_text():
    user_input = entry.get()
    print(f"用户输入: {user_input}")

get_button = tk.Button(root, text="获取输入", command=get_text)
get_button.pack()

3.4 文本框 (Text)

1
2
3
4
5
6
7
8


text_widget = tk.Text(root, height=5, width=40)
text_widget.pack()

# 插入文本
text_widget.insert("1.0", "这是一个多行文本框\n")

# 获取所有文本
content = text_widget.get("1.0", "end")

3.5 列表框 (Listbox)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


listbox = tk.Listbox(root, height=4)
for item in ["选项1", "选项2", "选项3", "选项4"]:
    listbox.insert("end", item)
listbox.pack()

# 获取选中项
def get_selection():
    selection = listbox.curselection()
    if selection:
        print(f"选中了: {listbox.get(selection[0])}")

3.6 框架 (Frame) - 容器组件

Frame 是 Tkinter 中最重要的容器组件之一，用于将其他组件分组和组织，让界面布局更加清晰和模块化。

你可以简单理解为html中的<div>标签，把上述的组件按模块化的思路放到不同的Frame中。

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


# 创建基本框架
frame = tk.Frame(root, bg="lightgray", relief="sunken", bd=2)
frame.pack(padx=10, pady=10, fill="both", expand=True)

# 在框架内添加组件
label_in_frame = tk.Label(frame, text="这是在框架内的标签")
label_in_frame.pack()

button_in_frame = tk.Button(frame, text="框架内的按钮")
button_in_frame.pack()

3.6.1 Frame 的常用参数

bg 或 background: 背景颜色
bd 或 borderwidth: 边框宽度
relief: 边框样式 (“flat”, “raised”, “sunken”, “groove”, “ridge”)
width, height: 框架尺寸

4. 布局管理

Tkinter 提供三种主要的布局管理器：

4.1 pack() - 简单布局

1
2
3
4
5


label1 = tk.Label(root, text="标签1", bg="red")
label1.pack(fill="x", padx=10, pady=5)

label2 = tk.Label(root, text="标签2", bg="green")
label2.pack(fill="x", padx=10, pady=5)

4.2 grid() - 网格布局

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


# 用户名
tk.Label(root, text="用户名:").grid(row=0, column=0, sticky="w")
username_entry = tk.Entry(root)
username_entry.grid(row=0, column=1, padx=5, pady=5)

# 密码
tk.Label(root, text="密码:").grid(row=1, column=0, sticky="w")
password_entry = tk.Entry(root, show="*")
password_entry.grid(row=1, column=1, padx=5, pady=5)

# 按钮
login_button = tk.Button(root, text="登录")
login_button.grid(row=2, column=0, columnspan=2, pady=10)

4.3 place() - 精确位置布局

1
2


button = tk.Button(root, text="精确位置")
button.place(x=100, y=50, width=100, height=30)

5. 完整示例：简易计算器

让我们用 Tkinter 创建一个简单的计算器：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46


import tkinter as tk

class Calculator:
    def __init__(self, root):
        self.root = root
        self.root.title("简易计算器")
        
        # 显示框
        self.display = tk.Entry(root, width=20, font=("Arial", 14), justify="right")
        self.display.grid(row=0, column=0, columnspan=4, padx=5, pady=5, ipady=10)
        
        # 按钮布局
        buttons = [
            '7', '8', '9', '/',
            '4', '5', '6', '*',
            '1', '2', '3', '-',
            '0', '.', '=', '+'
        ]
        
        row = 1
        col = 0
        for button in buttons:
            cmd = lambda x=button: self.button_click(x)
            tk.Button(root, text=button, width=5, height=2, 
                     command=cmd).grid(row=row, column=col, padx=2, pady=2)
            col += 1
            if col > 3:
                col = 0
                row += 1
    
    def button_click(self, char):
        if char == '=':
            try:
                result = eval(self.display.get())
                self.display.delete(0, "end")
                self.display.insert("end", str(result))
            except:
                self.display.delete(0, "end")
                self.display.insert("end", "错误")
        else:
            self.display.insert("end", char)

# 创建计算器实例
root = tk.Tk()
calc = Calculator(root)
root.mainloop()

6. 进阶功能

6.1 菜单栏

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12


def create_menu(root):
    menubar = tk.Menu(root)
    
    # 文件菜单
    file_menu = tk.Menu(menubar, tearoff=0)
    file_menu.add_command(label="新建")
    file_menu.add_command(label="打开")
    file_menu.add_separator()
    file_menu.add_command(label="退出", command=root.quit)
    menubar.add_cascade(label="文件", menu=file_menu)
    
    root.config(menu=menubar)

6.2 消息框

1
2
3
4
5
6
7
8
9


from tkinter import messagebox

def show_info():
    messagebox.showinfo("信息", "这是一个信息对话框")

def ask_question():
    result = messagebox.askyesno("确认", "你确定要执行此操作吗?")
    if result:
        print("用户选择了是")

6.3 文件对话框

1
2
3
4
5
6


from tkinter import filedialog

def open_file():
    file_path = filedialog.askopenfilename()
    if file_path:
        print(f"选择的文件: {file_path}")

7. 使用 Frame 进行复杂布局

上面提到Frame，这里另外开一段内容，主要是因为有Frame的存在，我们可以创建复杂的、有组织的界面布局：

7.1 创建表单布局

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31


def create_form():
    # 主框架
    main_frame = tk.Frame(root, padx=20, pady=20)
    main_frame.pack(fill="both", expand=True)
    
    # 个人信息框架
    personal_frame = tk.LabelFrame(main_frame, text="个人信息", padx=10, pady=10)
    personal_frame.pack(fill="x", pady=(0, 10))
    
    # 在个人信息框架中添加字段
    tk.Label(personal_frame, text="姓名:").grid(row=0, column=0, sticky="w", padx=(0, 5))
    tk.Entry(personal_frame, width=20).grid(row=0, column=1)
    
    tk.Label(personal_frame, text="邮箱:").grid(row=1, column=0, sticky="w", padx=(0, 5))
    tk.Entry(personal_frame, width=20).grid(row=1, column=1)
    
    # 地址信息框架
    address_frame = tk.LabelFrame(main_frame, text="地址信息", padx=10, pady=10)
    address_frame.pack(fill="x", pady=(0, 10))
    
    tk.Label(address_frame, text="地址:").grid(row=0, column=0, sticky="w", padx=(0, 5))
    tk.Entry(address_frame, width=30).grid(row=0, column=1)
    
    # 按钮框架
    button_frame = tk.Frame(main_frame)
    button_frame.pack(fill="x")
    
    tk.Button(button_frame, text="提交").pack(side="right", padx=(5, 0))
    tk.Button(button_frame, text="取消").pack(side="right")

create_form()

7.2 使用 Frame 创建侧边栏和主内容区

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31


def create_sidebar_layout():
    # 主容器
    main_container = tk.Frame(root)
    main_container.pack(fill="both", expand=True)
    
    # 侧边栏
    sidebar = tk.Frame(main_container, bg="lightblue", width=150)
    sidebar.pack(side="left", fill="y")
    sidebar.pack_propagate(False)  # 防止侧边栏被内容压缩
    
    # 在侧边栏添加按钮
    buttons = ["首页", "设置", "帮助", "关于"]
    for i, text in enumerate(buttons):
        btn = tk.Button(sidebar, text=text, width=12, 
                       command=lambda t=text: print(f"点击了 {t}"))
        btn.pack(pady=5, padx=10)
    
    # 主内容区
    content = tk.Frame(main_container, bg="white")
    content.pack(side="left", fill="both", expand=True)
    
    # 在主内容区添加内容
    title_label = tk.Label(content, text="主内容区域", 
                          font=("Arial", 16), bg="white")
    title_label.pack(pady=20)
    
    content_text = tk.Text(content, wrap="word", height=10)
    content_text.pack(fill="both", expand=True, padx=20, pady=10)
    content_text.insert("1.0", "这里是主要内容...")

create_sidebar_layout()

7.3 嵌套 Frame 创建复杂界面

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56


def create_nested_frames():
    # 主窗口
    main_window = tk.Frame(root, bg="lightgray")
    main_window.pack(fill="both", expand=True, padx=10, pady=10)
    
    # 顶部工具栏
    toolbar = tk.Frame(main_window, bg="darkgray", height=40)
    toolbar.pack(fill="x", pady=(0, 10))
    toolbar.pack_propagate(False)
    
    # 工具栏按钮
    tools = ["新建", "打开", "保存", "打印"]
    for tool in tools:
        btn = tk.Button(toolbar, text=tool)
        btn.pack(side="left", padx=5)
    
    # 内容区域（左右分栏）
    content_area = tk.Frame(main_window)
    content_area.pack(fill="both", expand=True)
    
    # 左侧面板
    left_panel = tk.LabelFrame(content_area, text="项目文件", width=200)
    left_panel.pack(side="left", fill="y")
    left_panel.pack_propagate(False)
    
    # 左侧面板内容
    file_list = tk.Listbox(left_panel)
    file_list.pack(fill="both", expand=True, padx=5, pady=5)
    for i in range(10):
        file_list.insert("end", f"文件 {i+1}")
    
    # 右侧编辑区
    right_panel = tk.Frame(content_area)
    right_panel.pack(side="left", fill="both", expand=True)
    
    # 右侧顶部状态栏
    status_bar = tk.Frame(right_panel, bg="lightyellow", height=25)
    status_bar.pack(fill="x")
    status_bar.pack_propagate(False)
    
    status_label = tk.Label(status_bar, text="就绪", bg="lightyellow")
    status_label.pack(side="left", padx=5)
    
    # 右侧编辑区域
    editor = tk.Text(right_panel, wrap="word")
    editor.pack(fill="both", expand=True, padx=5, pady=5)
    
    # 底部状态栏
    bottom_status = tk.Frame(main_window, bg="darkgray", height=20)
    bottom_status.pack(fill="x", pady=(10, 0))
    bottom_status.pack_propagate(False)
    
    bottom_label = tk.Label(bottom_status, text="行 1, 列 1", bg="darkgray", fg="white")
    bottom_label.pack(side="right", padx=5)

create_nested_frames()

7.4 使用 Frame 实现滚动框架

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33


class ScrollableFrame(tk.Frame):
    def __init__(self, parent, *args, **kwargs):
        super().__init__(parent, *args, **kwargs)
        
        # 创建画布和滚动条
        self.canvas = tk.Canvas(self, borderwidth=0)
        self.scrollbar = tk.Scrollbar(self, orient="vertical", command=self.canvas.yview)
        self.scrollable_frame = tk.Frame(self.canvas)
        
        self.scrollable_frame.bind(
            "<Configure>",
            lambda e: self.canvas.configure(scrollregion=self.canvas.bbox("all"))
        )
        
        self.canvas.create_window((0, 0), window=self.scrollable_frame, anchor="nw")
        self.canvas.configure(yscrollcommand=self.scrollbar.set)
        
        self.canvas.pack(side="left", fill="both", expand=True)
        self.scrollbar.pack(side="right", fill="y")
        
        # 绑定鼠标滚轮
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)
    
    def _on_mousewheel(self, event):
        self.canvas.yview_scroll(int(-1*(event.delta/120)), "units")

# 使用滚动框架
scroll_frame = ScrollableFrame(root)
scroll_frame.pack(fill="both", expand=True)

# 添加大量内容
for i in range(50):
    tk.Label(scroll_frame.scrollable_frame, text=f"项目 {i+1}").pack(anchor="w")

7.5 动态显示/隐藏框架

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18


def toggle_frame_visibility():
    def hide_frame():
        frame.pack_forget()  # 隐藏框架
        toggle_btn.config(text="显示框架", command=show_frame)
    
    def show_frame():
        frame.pack(fill="x", pady=10)  # 显示框架
        toggle_btn.config(text="隐藏框架", command=hide_frame)
    
    frame = tk.Frame(root, bg="lightgreen", height=50)
    frame.pack(fill="x", pady=10)
    
    tk.Label(frame, text="这个框架可以显示/隐藏", bg="lightgreen").pack(pady=10)
    
    toggle_btn = tk.Button(root, text="隐藏框架", command=hide_frame)
    toggle_btn.pack(pady=5)

toggle_frame_visibility()

7.6 Frame 的最佳实践

模块化设计: 将相关的组件放在同一个 Frame 中
层次结构: 使用嵌套 Frame 创建清晰的界面层次
命名规范: 为重要的 Frame 设置有意义的变量名
布局一致性: 在同一个 Frame 中使用相同的布局管理器
响应式设计: 合理使用 fill 和 expand 参数让界面适应窗口大小

8. Tkinter 实践建议

代码组织：对于复杂应用，使用面向对象的方式组织代码
错误处理：在事件处理函数中添加适当的异常处理
用户体验：考虑添加加载状态、确认对话框等
可访问性：为组件设置合理的键盘快捷键和焦点顺序

9. 总结

Tkinter 是 Python GUI 编程的强大工具，虽然它可能不像某些第三方库那样功能丰富，但对于大多数桌面应用来说已经足够了。

通过掌握基本组件、布局管理和事件处理，你就能创建出功能完善的图形界面应用。

希望这篇指南能帮助你开始 Tkinter 之旅！如果有任何问题或想法，欢迎在评论区分享。