VSCode内pyodbc.drivers()返回空、无法连接SQL Server但终端运行正常的问题

驱动识别异常和ODBC驱动本身的安装完整性无关，本质是VSCode启动的进程环境，和能正常运行脚本的系统终端进程环境存在关键差异，叠加conda环境的隔离特性，导致unixODBC驱动管理器无法定位到驱动配置。
两个观测到的现象完全可以对应这个逻辑：

• 系统终端下pyodbc能正常返回驱动列表，是因为终端启动时会加载完整的用户登录shell配置，自动把ODBC驱动的系统配置路径、动态库搜索路径加载到进程环境里，unixODBC能正常读取/etc/odbcinst.ini里记录的ODBC Driver 17的库路径，自然可以正常识别驱动。
• VSCode下pyodbc返回空驱动列表、报找不到库的错，是因为VSCode如果从桌面图标启动，不会执行登录shell的初始化流程，读不到系统级的ODBC相关环境变量，unixODBC驱动管理器找不到驱动配置文件的位置，哪怕驱动文件实际存在于硬盘上，也不知道要加载哪个路径的动态库，最终报出"file not found"的错误——这个报错不是真的找不到驱动文件，是驱动管理器的搜索路径里根本没有对应驱动的配置项。

• VSCode关联的Python解释器，和终端里跑通脚本的conda环境解释器路径不匹配。比如终端里激活的是自定义路径下的conda虚拟环境，但VSCode自动匹配到了系统Python、base环境Python，甚至是同名但实际安装位置不同的解释器，pyodbc加载的动态库本身就和终端环境不一致。
• VSCode主进程没有继承系统的ODBC相关环境变量。Linux桌面环境下，从应用菜单启动的GUI程序，默认只会加载基础的桌面环境变量，不会读取/etc/profile、~/.bashrc、~/.profile里的自定义配置，而unixODBC依赖的ODBCSYSINI（驱动配置文件所在路径）、LD_LIBRARY_PATH（动态库搜索路径）往往都写在这些shell初始化文件里，缺了这些变量驱动管理器完全无法工作。
• conda环境的库路径冲突。如果conda环境里误装了独立的unixODBC包，VSCode环境下pyodbc会优先加载conda环境内自带的精简版unixODBC库，这个库本身没有指向系统级ODBC驱动的配置，就会出现驱动列表为空的情况。

• 核对解释器路径
  在能正常跑通脚本的系统终端里，激活对应的conda环境，执行which python拿到完整的解释器路径（类似/home/xxx/miniconda3/envs/your_env/bin/python），然后在VSCode里按Ctrl+Shift+P打开命令面板，选择「Python: Select Interpreter」，手动选择上面拿到的完整路径，不要用VSCode自动匹配的同名解释器。
• 快速验证环境变量影响
  完全退出所有VSCode窗口，回到刚才能正常运行脚本的系统终端，保持conda环境激活的状态，直接输入code启动VSCode。这种方式启动的VSCode主进程会完全继承终端里的所有环境变量，包括ODBC相关的路径配置，启动后再打开项目运行脚本，调用pyodbc.drivers()验证是否能正常返回驱动列表。如果这时候能正常连接数据库，就可以确定问题是VSCode从桌面启动时没拿到系统环境变量导致的。
• 长期修复桌面启动的环境问题
  如果验证后确实是环境变量缺失的问题，可以手动把ODBC相关的配置写到桌面程序能读取的位置：
  • 把unixODBC的系统配置路径写入~/.profile：添加行export ODBCSYSINI=/etc（对应系统里odbcinst.ini文件所在的目录）
  • 把微软ODBC驱动的动态库路径加入动态库搜索路径：在~/.profile添加行export LD_LIBRARY_PATH=/usr/lib/x86_64-linux-gnu:$LD_LIBRARY_PATH
    保存后重新登录系统，从桌面图标启动VSCode也能正常识别ODBC驱动。
• 排查conda库冲突
  在VSCode环境的Python解释器里，执行下面的代码确认pyodbc加载的unixODBC库路径：

  import ctypes
  lib = ctypes.CDLL("libodbc.so.1")
  print(lib._name)
  

  如果打印的路径是conda虚拟环境目录下的libodbc，就说明存在库冲突，只需要在conda环境里卸载conda安装的unixODBC包（执行conda remove unixodbc），让pyodbc加载系统提供的unixODBC库即可。

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