M1芯片Mac导入psycopg2时出现ImportError架构不兼容报错

报错核心为加载的_psycopg.cpython-39-darwin.so动态库为x86_64架构，与当前环境要求的arm64e架构不匹配。此前尝试更换psycopg2/psycopg2-binary版本、Rosetta模式安装仍失败，本质是安装链路中终端、Python、依赖包、系统库的架构没有全程对齐，按以下步骤操作即可解决：

• 1. 清理残留旧版本
     先完全卸载所有已安装的psycopg2相关包，避免旧so文件残留干扰：

  pip uninstall -y psycopg2 psycopg2-binary
  

  卸载完成后进入对应虚拟环境的site-packages目录，手动删除所有名称包含psycopg2的文件夹。
• 2. 校验当前运行环境架构
     终端执行arch命令，确认输出为arm64，若输出为i386说明终端运行在Rosetta转译模式，需关闭Rosetta用原生arm模式启动终端。
     再执行以下命令确认Python本身的架构：

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

  输出必须为arm64，如果输出为x86_64，说明安装的Python是x86版本，需要先卸载后安装arm原生版本的Python，不要混用架构。
• 3. 安装arm原生PostgreSQL客户端依赖
     使用arm架构的Homebrew安装PostgreSQL客户端库，为后续源码编译psycopg2提供依赖：

  arch -arm64 brew install postgresql
  

  安装完成后执行which pg_config，确认输出路径为/opt/homebrew/bin/pg_config（arm版Homebrew默认路径，x86版路径为/usr/local/bin/pg_config，如果输出是后者说明用的是x86版Homebrew，需要重新安装arm版）。
• 4. 源码编译安装arm版psycopg2
     不要直接安装psycopg2-binary，其预编译包极易出现架构不匹配问题，执行以下命令强制源码编译安装：

  arch -arm64 pip install psycopg2 --no-binary :all:
  

  如果安装时报找不到头文件或库文件的错误，手动指定Homebrew的依赖路径执行：

  arch -arm64 pip install psycopg2 --no-binary :all: --global-option=build_ext --global-option="-L/opt/homebrew/lib" --global-option="-I/opt/homebrew/include"
  

• 5. 安装验证
     执行以下命令验证导入是否正常：

  python -c "import psycopg2"
  

  无任何输出即代表导入成功。也可以执行file 你的虚拟环境路径/lib/python3.9/site-packages/psycopg2/_psycopg.cpython-39-darwin.so，确认输出中包含arm64标识，即代表动态库架构匹配。

避坑提示：不要在同一个虚拟环境下混用不同架构的pip安装操作，如果需要同时运行x86架构的Python项目，单独创建对应架构的虚拟环境，和arm环境完全隔离使用，避免依赖架构冲突。

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