如何在未装Python的电脑运行依赖pyodbc的Python exe程序？

核心原因 #

pyodbc依赖系统级的SQL Server ODBC驱动（如ODBC Driver 17 for SQL Server），PyInstaller仅打包Python代码及依赖库，不会包含这类系统级驱动程序，因此未安装对应驱动的目标机器会报错。

无需安装Python的可行方案 #

1. 打包时嵌入驱动文件（限特定版本兼容场景） #

• 找到本地已安装的SQL Server ODBC驱动文件（如msodbcsql17.dll），路径通常为C:\Windows\System32（64位程序）或C:\Windows\SysWOW64（32位程序）
• 修改PyInstaller的.spec配置文件，将驱动文件加入打包资源：

  a = Analysis(
      ['your_main_script.py'],
      datas=[('C:\\Windows\\System32\\msodbcsql17.dll', '.')],
      # 保留原有其他配置项
  )
  

• 重新执行打包命令：pyinstaller your_script.spec
• 注意：不同Windows版本可能存在驱动兼容性差异，优先选择通用版本（如ODBC Driver 17 for SQL Server）

2. 切换至纯Python实现的SQL Server连接库 #

替换pyodbc为无需系统驱动的纯Python库，打包时可直接包含所有依赖：

• pymssql：基于FreeTDS的纯Python连接库，无需额外系统驱动
  • 安装：pip install pymssql
  • 代码替换示例：

    import pymssql
    # 替换原有pyodbc连接逻辑
    conn = pymssql.connect(server='你的SQL服务器地址', user='用户名', password='密码', database='目标数据库')
    

• 若使用ORM框架（如SQLAlchemy），可搭配pymssql作为底层驱动，确保所有依赖均为纯Python包

3. 分发驱动安装包并自动部署 #

• 下载微软官方的独立SQL Server ODBC驱动安装包（如msodbcsql17.msi），该安装程序无需Python环境即可运行
• 编写批处理文件，实现驱动自动检查与安装，再启动exe：

  @echo off
  rem 检查ODBC驱动是否已安装
  reg query "HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\ODBC Driver 17 for SQL Server" >nul 2>&1
  if %errorlevel% neq 0 (
      echo 正在安装SQL Server ODBC驱动...
      msodbcsql17.msi /quiet
  )
  echo 启动程序...
  start your_program.exe
  

• 将exe、驱动安装包、批处理文件放在同一目录分发给用户

额外注意事项 #

• 若目标机器为32位系统，需确保打包用的Python、PyInstaller及驱动均为32位版本，避免位数不匹配
• 需在不同Windows版本（Win7/Win10/Win11）上测试兼容性，保证分发后的程序正常运行

内容的提问来源于stack exchange，提问作者Oihane