在 Python 中，Tkinter 是一个内置的图形用户界面（graphical user interfaces, aka GUI)库

无需额外安装即可使用。它提供了创建窗口、按钮、文本框、菜单等组件的功能，让你可以快速搭建桌面应用程序

1. 快速开始：创建一个“大黄猫吃小动物”文本显示窗口

import tkinter as tk #设置别名
from tkinter import font 导入字体

窗口 = tk.Tk() #创建一个主窗口对象
窗口.title("事件描述")

# 获取屏幕尺寸
屏幕宽度 = 窗口.winfo_screenwidth()
屏幕高度 = 窗口.winfo_screenheight()

# 设置窗口大小尺寸为黄金分割比，位置居中屏幕
窗口宽度 = 324
窗口高度 = 200
x坐标 = (屏幕宽度 - 窗口宽度) // 2
y坐标 = (屏幕高度 - 窗口高度) // 2
窗口.geometry(f"{窗口宽度}x{窗口高度}+{x坐标}+{y坐标}") # 使用geometry设置窗口大小和位置

# 创建字体对象，设置字体为Myriad Set Pro，大小为26，加粗
自定义字体 = font.Font(family="Myriad Set Pro", size=26, weight="bold")

标签 = tk.Label(窗口, text="大黄猫吃小动物", font=自定义字体)  # 使用font参数设置字体
标签.place(relx=0.5, rely=0.5, anchor="center") # 使用place布局，将标签放置在窗口正中央，relxx'和'rely'参数表示相对于窗口的相对位置，'anchor'参数表示对齐方式

窗口.mainloop()  # 让窗口保持显示并等待用户操作

2. 常用组件

• Tkinter 提供了多种组件(a variety of components)(控件,widgets)用于构建界面(building interfaces)
• 如 Label、Button、Entry、Text、Checkbutton、Radiobutton、Scale 等
• 下面示例展示(demonstrate)几个常见组件的使用方式

2.1 标签与按钮

import tkinter as tk
# 点击按钮后，终端会输出“按钮已被点击”
def say_hello():
    print("按钮已被点击")  

窗口 = tk.Tk()
窗口.title("按钮测试")

提示语 = tk.Label(窗口, text="这是一个按钮")
提示语.pack()

# 创建一个按钮，点击后会执行say_hello函数
按钮 = tk.Button(窗口, text="快点我", command=say_hello)
按钮.pack()

窗口.mainloop()

2.2 文本输入框 (Entry)

import tkinter as tk

def 获取输入():
    大黄猫的输入 = 输入框.get()  # 输入框.get()获取输入框中的内容
    print(f"大黄猫输入的内容是: {大黄猫的输入}") #终端输出

窗口 = tk.Tk()
窗口.title("测试文本输入")

输入框 = tk.Entry(窗口) 
输入框.pack()

# 添加一个按钮，点击时调用获取输入函数
按钮 = tk.Button(窗口, text="获取输入", command=获取输入)
按钮.pack()

窗口.mainloop()

说明：示例中的变量"输入框"是为了便于理解而命名，实际运用中请替换为entry, "按钮"替换为btn, "窗口"替换为root

3. 布局管理器 (Layout Managers)

Tkinter 提供了三种主要的布局管理器：pack, grid, place。

3.1 pack

• 以顺序方式将组件排列在窗口中，常用 side 参数指定放置方向（top, bottom, left, right）。

import tkinter as tk

窗口 = tk.Tk()

tk.Label(窗口, text="顶部标签").pack(side="top")
tk.Label(窗口, text="底部标签").pack(side="bottom")

窗口.mainloop()

3.2 grid

• 采用行列网格方式管理布局，常用 row、column 指定位置。

# 测试grid布局
import tkinter as tk
窗口 = tk.Tk()
tk.Label(窗口, text="标签1").grid(row=0, column=0) # 第一行第一列
tk.Label(窗口, text="标签2").grid(row=0, column=1) # 第一行第二列
窗口.mainloop()

#示例2
import tkinter as tk
窗口 = tk.Tk()
for 行 in range(2):
    for 列 in range(2):
        tk.Label(窗口, text=f"第 {行} 行, 第 {列} 列", borderwidth=2, relief="groove").grid(row=行, column=列, padx=5, pady=5)
窗口.mainloop()
# borderwidth 边框宽度, relief 边框样式,groove 3D 效果

3.3 place

• 绝对定位布局，通过 x、y 指定位置。适合对精确像素定位有需求的场景，但一般不推荐使用。
  (Places widgets at absolute coordinates, rarely used unless you need precise pixel control.)

4. 事件与回调 (Events & Callbacks)

在 Tkinter 中，可以通过事件绑定让组件对用户操作做出响应。比如鼠标点击、键盘输入等。

import tkinter as tk
def on_click(event): 
    print(f"鼠标点击位置: {event.x}, {event.y}")

窗口 = tk.Tk()
窗口.title("测试鼠标点击事件")

画布 = tk.Canvas(窗口, width=200, height=200, bg="lightblue") #Canvas是一个画布控件，用于绘制图形和显示文本
画布.bind("<Button-1>", on_click) # 绑定鼠标左键点击事件到on_click函数，"<Button-1>"表示鼠标左键点击事件
画布.pack()

窗口.mainloop()

5. 项目案例：

5.1 简易计数器 (Mini Project: Counter)

import tkinter as tk    
def 增加计数():
    global 计数
    计数 += 1
    标签.config(text=str(计数))

窗口 = tk.Tk()
窗口.title("简易计数器")

计数 = 0
标签 = tk.Label(窗口, text=str(计数), font=("Arial", 24))
标签.pack(padx=20, pady=20)
按钮 = tk.Button(窗口, text="增加计数", command=增加计数)
按钮.pack()

窗口.mainloop()

5.2 进度条示例

import tkinter as tk
def 开始进度():
    for i in range(101):
        进度条['value'] = i # 设置进度条的值
        窗口.update_idletasks() # 更新窗口, 让进度条显示出来
        time.sleep(0.05)  # 模拟耗时操作

窗口 = tk.Tk()
窗口.title("进度条示例")

# 创建进度条,progressbar是进度条控件, orient是进度条的方向, length是进度条的长度, mode是进度条的模式
进度条 = ttk.Progressbar(窗口, orient="horizontal", length=300, mode="determinate") 
进度条.pack(padx=20, pady=20)

开始按钮 = tk.Button(窗口, text="开始", command=开始进度)
开始按钮.pack()

窗口.mainloop()

5.3 文件选择器

import tkinter as tk
from tkinter import filedialog # filedialog是一个对话框控件, 用于选择文件和文件夹

def 选择文件():
    文件路径 = filedialog.askopenfilename(title="选择文件") # askopenfilename是一个对话框函数, 用于选择文件
    if 文件路径:
        标签.config(text=f"已选择文件: {文件路径}") # 标签.config是一个标签控件的方法, 用于设置标签的文本

窗口 = tk.Tk()
窗口.title("文件选择器")

标签 = tk.Label(窗口, text="点击按钮选择文件", width=50)
标签.pack(padx=20, pady=20)

按钮 = tk.Button(窗口, text="选择文件", command=选择文件)
按钮.pack()

窗口.mainloop()

6. 小贴士与注意事项 (Tips & Caveats)

1. 命名约定：常将主窗口命名为 root 或 window，方便阅读。
2. 布局管理器：多种布局可组合使用，但同一容器（如一个 Frame）应使用同一种布局，以免冲突。(Use only one geometry manager in the same container to avoid conflicts.)
3. 打包与发布：如果需要将 Tkinter 程序分发给不懂编程的用户，可使用如 pyinstaller 将脚本打包成可执行文件。(Use tools like pyinstaller to distribute your Tkinter apps as standalone executables.)