PyCharm Python控制台中Poetry环境包导入失败问题

问题根源 #

核心问题是M1/M2系列Mac（arm64架构）上，psycopg2包是在x86_64架构（Rosetta模拟）下安装的，而PyCharm或手动运行的Python是arm64架构，导致二进制不兼容；同时Poetry环境的架构与PyCharm识别的环境不匹配，引发模块找不到的错误。

解决步骤 #

1. 确保终端与Poetry为arm64架构 #

• 检查终端架构：右键终端应用→显示简介，取消勾选「使用Rosetta打开」，重启终端。
• 验证终端架构：执行uname -m，输出应为arm64。
• 重新安装arm64版本的Poetry（若之前是Rosetta下安装的）：

  # 卸载现有Poetry
  curl -sSL https://install.python-poetry.org | python3 - --uninstall
  # 重新安装
  curl -sSL https://install.python-poetry.org | python3 -
  

• 验证Poetry环境架构：

  poetry run python -c "import platform; print(platform.machine())"
  

  输出必须为arm64，否则说明环境还是x86_64架构。

2. 重建Poetry虚拟环境 #

• 删除现有不兼容的虚拟环境：

  poetry env remove 3.11
  

• 重新创建环境并安装所有依赖：

  poetry install
  

• 验证psycopg2的架构：

  # 获取psycopg2的安装路径
  poetry run python -c "import psycopg2; print(psycopg2.__file__)"
  # 检查该文件的架构（替换成上面输出的路径）
  file /path/to/psycopg2/__init__.py
  

  输出应包含arm64，确认是适配本机架构的版本。

3. 正确配置PyCharm的解释器 #

• 打开PyCharm，进入File > Settings > Project: [你的项目名] > Python Interpreter（Mac上是PyCharm > Settings > ...）。
• 点击右上角的齿轮图标，选择Add。
• 在弹出的窗口中，选择Virtualenv Environment，勾选Existing environment。
• 点击路径浏览按钮，找到新创建的Poetry虚拟环境路径（通过poetry env info -p获取），选中路径下的bin/python文件。
• 点击OK保存，等待PyCharm完成依赖索引。
• 验证：在PyCharm的Python控制台执行以下命令，无报错则说明配置成功：

  import psycopg2
  import platform
  print(platform.machine())  # 应输出arm64
  

4. 备选方案：改用psycopg2-binary #

如果上述步骤仍无法解决编译问题，可改用预编译的psycopg2-binary包（官方提供的适配多架构版本）：

• 修改项目根目录的pyproject.toml，将psycopg2替换为：

  psycopg2-binary = "^2.9.9"
  

• 执行更新命令：

  poetry update psycopg2-binary
  

• 重复步骤3，重新配置PyCharm解释器即可。

额外注意 #

确保PyCharm本身是arm64版本：右键PyCharm应用→显示简介，取消勾选「使用Rosetta打开」，否则PyCharm会强制使用x86_64架构的解释器，导致架构不兼容问题。

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