Ubuntu23.04下PyCharm无法识别编译安装的Python3.10解释器求助

PyCharm无法识别自定义编译Python3.10的venv的原因及解决 #

1. 编译Python3.10时依赖缺失（核心原因） #

自定义编译Python时如果缺少必要依赖，会导致Python部分功能组件缺失，PyCharm无法正常识别该解释器及其创建的venv。

补全依赖并重新编译Python3.10

先安装编译依赖：

sudo apt-get install build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev

重新下载并编译Python3.10（指定明确路径，避免干扰系统默认Python）：

# 下载对应版本源码包（以3.10.13为例）
wget https://www.python.org/ftp/python/3.10.13/Python-3.10.13.tgz
tar xzf Python-3.10.13.tgz
cd Python-3.10.13
# 配置编译参数：启用共享库、指定安装路径、确保pip被安装
./configure --enable-shared --prefix=/usr/local/python3.10 --with-ensurepip=install
# 并行编译（自动利用全部CPU核心）
make -j$(nproc)
# 使用altinstall避免覆盖系统默认Python
sudo make altinstall

配置共享库路径

编译时启用了--enable-shared，需要让系统能找到Python3.10的共享库：

sudo echo "/usr/local/python3.10/lib" >> /etc/ld.so.conf.d/python3.10.conf
sudo ldconfig

2. PyCharm手动指定解释器 #

如果重新编译后仍无法自动识别，手动添加解释器：

• 打开PyCharm，进入File > Settings > Project: [你的项目名] > Python Interpreter
• 点击右上角齿轮图标，选择Add
• 在弹出窗口选择Existing environment，点击路径选择按钮，手动定位到：
  • 系统级Python3.10：/usr/local/python3.10/bin/python3.10
  • 已创建的venv解释器：/path/to/your/venv/bin/python3.10
• 点击OK完成添加，PyCharm即可正常识别并使用该解释器。

Ubuntu23.04下Python3.10与3.11共存的正确姿势 #

• 绝不修改系统默认软链接：不要改动/usr/bin/python或/usr/bin/python3的指向，否则会破坏apt、dpkg等系统工具的正常运行。
• 明确指定版本调用：直接用python3.10和python3.11分别调用对应版本解释器，用pip3.10和pip3.11安装对应版本的包。
• 创建venv时指定版本：基于Python3.10创建独立虚拟环境，避免版本污染：

  /usr/local/python3.10/bin/python3.10 -m venv my_py310_venv
  

• 激活venv后自动切换版本：激活虚拟环境后，python和pip会自动指向venv内的Python3.10，无需加后缀：

  source my_py310_venv/bin/activate
  python -V  # 输出Python 3.10.x
  

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