直接结论：不是pyodbc没装，而是系统里压根没注册可用的sql server odbc驱动，或者pyodbc 5.2+版本因encoding参数误用触发了驱动解析失败。检查系统已安装的odbc驱动列表这是最不该跳过的一步。
直接结论：不是pyodbc没装，而是系统里压根没注册可用的SQL Server ODBC驱动，或者pyodbc 5.2+版本因encoding参数误用触发了驱动解析失败。
检查系统已安装的ODBC驱动列表
这是最不该跳过的一步。pyodbc本身能告诉你它“看见”了什么，而不是你“以为”装了什么。
- 运行
import pyodbc; print(pyodbc.drivers()) - 如果输出为空，或不包含类似
ODBC Driver 17 for SQL Server、ODBC Driver 18 for SQL Server这样的字符串，说明驱动未正确注册 - Windows用户可打开
odbcad32.exe（64位系统用C:\Windows\SysWOW64\odbcad32.exe查32位驱动），切换到“驱动程序”选项卡确认 - macOS用户执行
odbcinst -j查配置路径，再 cat/opt/homebrew/etc/odbcinst.ini（或对应路径）看是否含有效驱动节
确认pyodbc与ODBC驱动的位数/架构匹配
32位Python进程找不到64位驱动，反之亦然——这个错不会报“位数不匹配”，只报“未发现数据源名称”。
- 查Python位数：
import platform; print(platform.architecture())，输出里带32bit就是32位 - Windows上，64位系统默认装的是64位ODBC驱动；若用32位Python（如某些旧版IDE自带），必须单独装32位驱动，或改用64位Python
- macOS上Homebrew默认装arm64驱动，M1/M2芯片需确认Python也是arm64架构（
file $(which python3)） - Linux用户注意unixODBC和msodbcsql包是否同为x86_64或aarch64
连接字符串中DRIVER值必须严格匹配驱动名
拼写差一个空格、大小写不一致、多写个“v”或少个“for”，都会导致驱动管理器找不到目标。
- 从
pyodbc.drivers()输出里原样复制驱动名，例如：DRIVER={ODBC Driver 18 for SQL Server} - 不要用过时的
{SQL Server}或{SQL Server Native Client 11.0}，它们在新系统上通常不可用 - 避免在连接字符串里混用DSN和DRIVER：要么纯DRIVER方式，要么单独配好系统DSN后只写
DSN=my_dsn - pyodbc 5.2+ 版本对连接字符串语法更敏感，不要加多余空格或换行符
pyodbc 5.2+ 的encoding参数陷阱
这个最容易被忽略：加了 encoding='utf-8' 反而让连接失败，错误还伪装成“驱动没找到”。
- SQL Server ODBC驱动内部使用UTF-16编码通信，pyodbc 5.2起不再自动转换或忽略非法encoding值
- 移除连接字符串或connect()调用中的
encoding参数（如pyodbc.connect(conn_str, encoding='utf-8')） - 若真需控制编码，应改用
unicode_results=True+ 数据库层字符集设置，而非在连接层硬设encoding - 升级pyodbc后老代码出问题，第一反应不该是重装驱动，而是先删掉encoding相关参数试试
真正卡住人的地方，往往不是驱动没装，而是驱动名抄错了、位数对不上、或者那个看似无害的encoding参数在pyodbc 5.2里悄悄变成了连接开关。跑一遍pyodbc.drivers()，再核对三遍驱动名和Python架构，90%的问题就定位完了。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
