### 正确安装并导入 psycopg2 包的方法 #### 1. Python 和 psycopg2 的兼容性 在 Mac M1 芯片环境下，已验证 Python 3.9 和 3.10 版本可能会导致 `psycopg2` 导入失败的问题。推荐使用的 Python 版本为 **3.8.6**，而对应的 `psycopg2` 版本应为 **2.8.6**[^1]。 --- #### 2. 安装步骤 ##### （1）安装 Python 3.8.6 前往官方 Python 网站下载适合的操作系统版本的 Python 3.8.6 并完成安装。如果使用 Homebrew，则可以通过以下命令安装： ```bash brew install python@3.8 ``` ##### （2）安装 OpenSSL 由于 `psycopg2` 需要依赖 OpenSSL 库来支持 PostgreSQL 连接功能，在 macOS 上需先通过 Homebrew 安装 OpenSSL： ```bash brew install openssl@1.1 ``` 完成后设置环境变量以便编译器能够找到 OpenSSL 头文件和库路径： ```bash export LDFLAGS="-L/usr/local/opt/openssl@1.1/lib" export CPPFLAGS="-I/usr/local/opt/openssl@1.1/include" export PKG_CONFIG_PATH="/usr/local/opt/openssl@1.1/lib/pkgconfig" ``` ##### （3）安装 psycopg2 通过 Pip 工具安装指定版本的 `psycopg2`： ```bash pip3 install psycopg2==2.8.6 ``` ##### （4）安装 psycopg2-binary（可选） 对于某些场景下可能更方便直接使用预编译好的二进制包 `psycopg2-binary`，可以直接运行如下命令安装： ```bash pip3 install psycopg2-binary==2.8.6 ``` 注意：尽管 `psycopg2-binary` 更容易安装，但在生产环境中建议优先考虑源码版 `psycopg2`，因为它更加灵活且性能更好。 --- #### 3. 测试导入是否正常工作 打开终端或者 IDE 中启动 Python 解释器，尝试执行以下代码片段以确认模块能否被正确加载： ```python import psycopg2 print(psycopg2.__version__) ``` 如果没有抛出异常说明安装成功。 --- #### 4. 使用示例 下面是一个简单的例子展示如何连接到 PostgreSQL 数据库以及查询数据表中的记录： ```python import psycopg2 try: connection = psycopg2.connect( user="your_username", password="your_password", host="localhost", # 或者远程服务器地址 port="5432", # 默认端口 database="your_database_name" ) cursor = connection.cursor() # 查询语句 query = "SELECT * FROM your_table;" cursor.execute(query) records = cursor.fetchall() # 获取所有返回的结果集 for row in records: print(row) except Exception as e: print(f"An error occurred: {e}") finally: if connection: cursor.close() connection.close() ``` 上述脚本展示了基本流程包括建立数据库链接、发送 SQL 请求读取数据以及关闭资源释放操作[^3]。 --- ###