开发桌面应用时安装pysqlite3-binary失败，求解决方法

一、先澄清一个误区 #

Python自带的sqlite3模块并非被弃用，它只是绑定了特定版本的SQLite库。你看到的"弃用"提示可能是指该绑定版本的某些特性过时，而非模块本身不可用。SQLite具备良好的向后兼容性，旧版本创建的数据库文件通常能被新版本正常读取，除非你使用了旧版本不支持的高级特性。

二、解决pysqlite3安装报错的问题 #

你遇到的pysqlite3-binary找不到的问题，大概率是包名或环境兼容问题，按以下步骤尝试：

1. 检查Python版本与环境
   打开终端执行：

   python --version
   

   确保你的Python版本在pysqlite3支持范围内（目前支持3.7+），同时确认你激活了项目对应的虚拟环境（如果使用的话）。

2. 尝试安装正确的包

   • 优先安装标准pysqlite3包：

     pip install pysqlite3
     

   • 如果仍失败，尝试指定兼容版本（比如当前稳定版）：

     pip install pysqlite3==0.5.10
     

   • 若你的系统是Windows且存在架构兼容问题，可尝试下载对应版本的预编译.whl文件，手动执行安装：

     pip install path/to/pysqlite3-binary-xxx.whl
     

3. 替换代码中的模块引用
   成功安装后，只需修改代码开头的导入语句，原有逻辑无需改动：

   import pysqlite3 as sqlite3
   from pysqlite3 import Error 
   

三、关于chromadb安装失败的问题 #

如果你并非必须使用chromadb，建议优先解决SQLite的版本问题，无需绕路。若确实需要安装chromadb，解决hnswlib编译失败的方法：

1. 安装预编译的hnswlib包
   先安装兼容的预编译版本：

   pip install hnswlib==0.7.0
   

2. 再安装指定版本的chromadb

   pip install chromadb==0.3.29
   

3. Windows用户补全编译依赖
   若仍失败，需安装Visual Studio Community版，并勾选"Desktop development with C++"组件，包含MSVC编译器、Windows SDK等编译工具。

四、临时替代方案：升级系统SQLite库（可选） #

如果不想更换Python模块，可尝试升级系统级的SQLite库，Python自带的sqlite3会自动调用系统最新版本（部分系统支持）：

• Windows：下载SQLite预编译二进制文件，替换系统路径中的sqlite3.dll
• Linux：通过包管理器升级，比如apt install sqlite3
• macOS：使用Homebrew升级brew install sqlite3

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