如何解决Tkinter执行SSH命令时界面冻结问题

问题原因 #

Tkinter的GUI运行在主线程中，所有用户交互、界面更新都依赖这个线程。你的connect方法里的SSH连接和命令执行是耗时的阻塞操作，会占据主线程，导致窗口无法处理其他事件（比如窗口拖动、按钮点击），从而出现冻结。

解决方案 #

使用Python的threading模块，把耗时的SSH操作放到子线程中执行，让主线程专注于GUI事件处理。注意：子线程不能直接更新Tkinter组件，需要通过after()方法让主线程来完成界面更新，保证线程安全。

修改后的完整代码 #

import tkinter as tk
from netmiko import ConnectHandler
import threading

class App:
    def __init__(self, master):
        self.master = master
        master.title("SSH Connect Tool")

        # Create labels
        self.ip_label = tk.Label(master, text="IP Addresses:")
        self.user_label = tk.Label(master, text="Username:")
        self.password_label = tk.Label(master, text="Password:")

        # Create textboxes
        self.ip_textbox = tk.Text(master, width=39, height=10)
        self.user_textbox = tk.Entry(master, width=30)
        self.password_textbox = tk.Entry(master, width=30, show="*")

        # Create output window
        self.output_window = tk.Text(master, width=60, height=20)

        # Create connect button
        self.connect_button = tk.Button(master, text="Connect", command=self.start_connect_thread)

        # Place labels on the left and textboxes on the right
        self.user_label.grid(row=0, column=0, padx=10, pady=10, sticky=tk.W)
        self.user_textbox.grid(row=0, column=1, padx=10, pady=10, sticky=tk.E)

        self.password_label.grid(row=1, column=0, padx=10, pady=10, sticky=tk.W)
        self.password_textbox.grid(row=1, column=1, padx=10, pady=10, sticky=tk.E)

        self.ip_label.grid(row=2, column=0, padx=10, pady=10, sticky=tk.W)
        self.ip_textbox.grid(row=2, column=1, padx=10, pady=10, sticky=tk.E)

        self.output_window.grid(row=3, column=0, columnspan=2, padx=10, pady=10, sticky=tk.W)

        self.connect_button.grid(row=4, column=1, padx=10, pady=10, sticky=tk.E)

    def start_connect_thread(self):
        # 禁用按钮防止重复点击
        self.connect_button.config(state=tk.DISABLED)
        # 清空输出窗口
        self.output_window.delete("1.0", tk.END)
        # 获取输入参数
        ips = self.ip_textbox.get("1.0", tk.END).splitlines()
        username = self.user_textbox.get()
        password = self.password_textbox.get()
        # 启动子线程执行SSH操作，daemon=True确保窗口关闭时线程自动退出
        threading.Thread(target=self.run_ssh_connections, args=(ips, username, password), daemon=True).start()

    def run_ssh_connections(self, ips, username, password):
        for ip in ips:
            ip = ip.strip()
            if not ip:  # 跳过空行
                continue
            device = {
                'device_type': 'cisco_xr',
                'ip': ip,
                'username': username,
                'password': password,
                'secret': password
            }
            try:
                with ConnectHandler(**device) as ssh:
                    # 用after让主线程更新输出
                    self.master.after(0, self.update_output, f"Connected to {ip}\n")
                    output = ssh.send_command("show ver")
                    self.master.after(0, self.update_output, output + "\n")
            except Exception as e:
                self.master.after(0, self.update_output, f"Error connecting to {ip}: {e}\n")
        # 所有操作完成后重新启用按钮
        self.master.after(0, lambda: self.connect_button.config(state=tk.NORMAL))

    def update_output(self, text):
        # 主线程中安全更新输出窗口
        self.output_window.insert(tk.END, text)
        self.output_window.see(tk.END)  # 自动滚动到最新内容

# Create GUI
root = tk.Tk()
app = App(root)
root.mainloop()

关键修改说明 #

• 新增start_connect_thread：负责参数获取、按钮禁用，启动子线程执行耗时操作
• 新增run_ssh_connections：作为子线程的核心逻辑，执行SSH连接和命令，通过after()将界面更新委托给主线程
• 新增update_output：专门用于主线程更新GUI，避免子线程直接操作组件引发的线程安全问题
• 加入按钮禁用/启用逻辑：防止用户重复触发操作，提升交互体验

内容的提问来源于stack exchange，提问作者Oscar Salgado Ortiz