如何使用Python Tkinter连接SQL Server并执行查询

PyODBC 是连接 SQL Server 最稳妥的选择，因其稳定支持 Windows 身份验证及新特性，而 pymssql 已进入维护模式；需正确配置连接字符串、线程隔离、Treeview 动态列定义和参数化查询。

PyODBC 连接 SQL Server 是最稳妥的选择

Tkinter 本身不处理数据库连接，真正干活的是 pyodbc。用它连 SQL Server 最稳定，Windows 上默认支持 Windows 身份验证，Linux/macOS 需装 unixodbc 和 Microsoft ODBC 驱动。别用 pymssql —— 它对 Azure AD 认证、Always Encrypted 等新特性支持弱，且已进入维护模式。

安装命令：

pip install pyodbc

• 连接字符串里必须含 DRIVER、SERVER、DATABASE；Windows 身份验证加 Trusted_Connection=yes
• SQL 登录方式要显式写 UID 和 PWD，密码含特殊字符需 URL 编码（比如 @ → %40）
• 如果报错 IM002: [Microsoft][ODBC Driver Manager] Data source name not found，说明驱动没装或名字写错了——运行 pyodbc.drivers() 查看可用驱动名

在 Tkinter GUI 中安全执行查询，避免阻塞界面

直接在按钮回调里调用 cursor.execute() 会卡死整个窗口，尤其查大数据量时。必须用 threading.Thread 或 after() 拆离主线程，但 pyodbc.Connection 不是线程安全的，不能跨线程复用连接对象。

• 每次查询新开连接、查完立刻 conn.close()，别试图“池化”或全局复用 Connection
• 结果集用 cursor.fetchall() 拿完再关连接；若数据超 10 万行，改用 fetchmany(1000) 分批读，避免内存爆掉
• 错误要捕获 pyodbc.Error，不是 Exception，否则 SQL 错误码（如 18456 登录失败）会被吞掉

把查询结果显示在 Tkinter 的 Treeview 里要注意字段对齐

ttk.Treeview 显示查询结果很常见，但直接塞 fetchall() 返回的 tuple 列表会出错：列数不匹配、中文乱码、数字右对齐缺失。

立即学习“Python免费学习笔记（深入）”；

• 先用 cursor.description 动态生成 Treeview["columns"] 和表头，别硬编码列名
• 插入数据前调用 tree["show"] = "headings"，否则首列显示空编号
• 数值型字段用 tree.column("col_name", anchor="e") 右对齐；中文列宽至少设 width=120，否则截断
• 如果字段含 None，Treeview 会显示为空白字符串，无需额外替换

参数化查询防 SQL 注入，Tkinter 输入框值必须转义

用户在 Entry 里输 “O’Malley”，拼字符串进 SQL 就会崩。Tkinter 没自带参数绑定机制，全靠 pyodbc 的 ? 占位符。

• 写 SQL 时用 WHERE name = ?，执行时传元组：cursor.execute(sql, (entry.get(),))
• 多个参数按顺序填，不要用字典（pyodbc 不支持命名参数）
• 日期字段传 datetime.date 对象，别传字符串；布尔字段传 True/False，不是 "1" 或 "true"
• 如果用户输入为空，entry.get() 返回空字符串，直接传进去就行，pyodbc 会当 NULL 处理

连接字符串格式、线程隔离、Treeview 列定义、参数占位符这四点漏掉任何一环，都会导致程序看似能跑但实际不可靠。尤其是 Windows 身份验证和 Linux 驱动差异，本地能连不代表部署就通。