如何修复pip安装openai时出现的subprocess-exited-with-error错误

问题原因 #

错误日志核心提示：UnicodeDecodeError: 'cp949' codec can't decode byte 0xe2，说明Windows系统默认用cp949编码解码openai包的UTF-8格式文件（如setup.py或说明文档中的特殊字符），导致解码失败，进而触发构建wheel的错误。

解决方法 #

方法1：临时设置UTF-8编码后安装 #

在命令行临时指定Python使用UTF-8编码，再执行安装：

• CMD命令提示符：

  set PYTHONUTF8=1
  pip install openai
  

• PowerShell：

  $env:PYTHONUTF8=1
  pip install openai
  

方法2：直接安装预编译wheel包（跳过源码构建） #

强制使用预编译二进制包，避开源码构建环节的编码问题：

pip install openai==0.26.0 --only-binary :all:

方法3：永久设置Python默认编码为UTF-8 #

通过系统环境变量配置，避免后续同类问题：

1. 右键「此电脑」→「属性」→「高级系统设置」→「环境变量」
2. 在「系统变量」区点击「新建」，输入：
   • 变量名：PYTHONUTF8
   • 变量值：1
3. 保存设置后重启命令行工具，再执行pip install openai

验证安装成功 #

安装完成后执行以下命令确认：

python -c "import openai; print(openai.__version__)"

输出0.26.0则表示安装成功。

内容的提问来源于stack exchange，提问作者김민우