Mac OS（Big Sur 11.5.2）安装pymssql包失败报错求助

错误原因说明 #

你遇到的两类报错原因如下：

• clang编译失败：pymssql需要依赖系统的FreeTDS和OpenSSL库才能从源码构建，Mac默认没有预装该依赖，也没有对应头文件路径的全局配置
• PEP 517构建失败：pymssql 2.1.5等旧版本不支持PEP 517构建流程，需要添加额外参数跳过该规则

具体解决步骤 #

步骤1：安装系统基础依赖 #

• 先安装Xcode命令行工具，已安装可跳过：
  xcode-select --install
• 用Homebrew安装pymssql所需的编译依赖：
  brew install freetds openssl

步骤2：配置编译环境变量 #

执行如下命令临时导入环境变量，也可以写入~/.zshrc（Intel芯片Mac）或~/.zprofile（M系列芯片Mac）永久生效：

注意：如果是M系列芯片Mac，需要将下方路径中的/usr/local/opt替换为/opt/homebrew/opt

export LDFLAGS="-L/usr/local/opt/openssl/lib -L/usr/local/opt/freetds/lib"
export CPPFLAGS="-I/usr/local/opt/openssl/include -I/usr/local/opt/freetds/include"
export PKG_CONFIG_PATH="/usr/local/opt/openssl/lib/pkgconfig:/usr/local/opt/freetds/lib/pkgconfig"

步骤3：安装pymssql #

• 安装最新版本pymssql：
  pip3 install pymssql
  如果使用pipenv管理环境，导入环境变量后执行pipenv install pymssql即可
• 安装指定2.1.5版本：
  需要添加参数跳过PEP 517检查：
  pip3 install pymssql==2.1.5 --no-use-pep517

步骤4：验证安装 #

执行如下命令，正常输出版本号即为安装成功：
python3 -c "import pymssql; print(pymssql.__version__)"

备选替代方案 #

如果多次尝试仍无法安装pymssql，可以使用功能相近、Mac兼容性更好的pyodbc库连接SQL Server：

1. 安装SQL Server ODBC驱动：
   brew install microsoft-mssql-tools18 msodbcsql18 unixodbc
2. 安装pyodbc：
   pip3 install pyodbc

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