Ubuntu环境下PyCharm如何升级所使用的SQLite3版本

PyCharm本身不内置供项目解释器调用的SQLite，你看到的3.31版本来自venv虚拟环境继承的Ubuntu 20.04系统Python3.8——这个版本的Python在apt源编译时就绑定了系统默认的SQLite 3.31，后续你升级系统全局sqlite3二进制文件，不会替换Python运行时加载的sqlite3动态链接库，所以PyCharm调用时始终读取旧版本。

方案1：替换Python绑定的sqlite3动态链接库（最快，无需重装环境） #

• 先查询系统升级后3.38版本的libsqlite3动态库路径，终端执行：
  find /usr -name "libsqlite3.so*" 2>/dev/null
  正常返回路径类似/usr/local/lib/libsqlite3.so.0.8.6，记录该路径。
• 激活你的项目venv，查询当前Python加载的旧版sqlite3库位置：

source 你的venv目录/bin/activate
python -c "import sqlite3; print('当前版本:', sqlite3.sqlite_version)"
ldd $(python -c "import _sqlite3; print(_sqlite3.__file__)") | grep sqlite

执行后会输出旧版libsqlite3.so的存放路径，通常在venv的lib/python3.8/lib-dynload/目录或系统Python的lib目录下。

• 备份旧库，将新版库软链接到旧库位置：

# 将路径替换为你上一步查询到的旧库存放路径
sudo mv /旧库路径/libsqlite3.so.0 /旧库路径/libsqlite3.so.0.bak
# 将路径替换为第一步查到的3.38版本动态库路径
sudo ln -s /新版库路径/libsqlite3.so.0.8.6 /旧库路径/libsqlite3.so.0

• 验证：venv内执行python -c "import sqlite3; print(sqlite3.sqlite_version)"，返回3.38即配置生效，重启PyCharm加载解释器后即可使用新版SQLite语法。

方案2：安装pysqlite3-binary做运行时替换（无需修改系统文件） #

如果不想改动系统链接库，直接在虚拟环境内安装预编译的新版SQLite绑定，在代码入口做映射即可：

• 激活venv后安装依赖：
  pip install pysqlite3-binary
• 在项目入口文件的最顶部添加以下代码，将全局sqlite3模块替换为新版：

import sys
sys.modules["sqlite3"] = __import__("pysqlite3")

• 该方式对SQLAlchemy等所有依赖sqlite3的库生效，无需修改其他业务代码，重启PyCharm运行项目即可识别3.33以上版本的SQLite语法。

方案3：重新编译Python绑定新版SQLite，重建虚拟环境 #

如果以上两种方式运行时出现兼容问题，可重新编译带新版SQLite绑定的Python3.8：

• 先确认系统已安装对应3.38版本的sqlite3开发包，执行sudo apt install libsqlite3-dev后，核对/usr/include/sqlite3.h里的版本号为3.38，若不是则将你手动升级的sqlite3头文件软链到该目录。
• 下载Python3.8源码包，解压后进入源码目录执行编译：

./configure --enable-optimizations LDFLAGS="-L/usr/local/lib" CPPFLAGS="-I/usr/local/include"
make -j$(nproc)
sudo make altinstall

• 用新编译完成的Python3.8重建项目venv，安装项目依赖后，在PyCharm中选择新venv作为项目解释器即可，该环境默认绑定SQLite 3.38版本。

注意：无需修改PyCharm安装目录下的任何文件，PyCharm自带数据库工具使用的SQLite和你项目代码调用的SQLite完全独立，业务代码的SQLite版本只由你选择的Python解释器决定。

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