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

问题背景 #

• 系统：Windows
• Python版本：3.11
• 前置操作：已将pip完全升级
• 问题现象：执行pip install openai时触发subprocess-exited-with-error，核心报错为：

  UnicodeDecodeError: 'cp949' codec can't decode byte 0xe2 in position 1031: illegal multibyte sequence
  

• 已尝试操作：试过针对文件读取的Unicode错误修复方案，但未解决问题

完整报错信息 #

Collecting openai
  Using cached openai-0.26.0.tar.gz (54 kB)
  Installing build dependencies ... done
  Getting requirements to build wheel ... error
  error: subprocess-exited-with-error

  × Getting requirements to build wheel did not run successfully.
  │ exit code: 1
  ╰─> [21 lines of output]
      Traceback (most recent call last):
        File "C:\Users\vocal\AppData\Local\Programs\Python\Python311\Lib\site-packages\pip\_vendor\pep517\in_process\_in_process.py", line 351, in <module>
          main()
        File "C:\Users\vocal\AppData\Local\Programs\Python\Python311\Lib\site-packages\pip\_vendor\pep517\in_process\_in_process.py", line 333, in main
          json_out['return_val'] = hook(**hook_input['kwargs'])
                                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "C:\Users\vocal\AppData\Local\Programs\Python\Python311\Lib\site-packages\pip\_vendor\pep517\in_process\_in_process.py", line 118, in get_requires_for_build_wheel
          return hook(config_settings)
                 ^^^^^^^^^^^^^^^^^^^^^
        File "C:\Users\vocal\AppData\Local\Temp\pip-build-env-lr3fjsgg\overlay\Lib\site-packages\setuptools\build_meta.py", line 338, in get_requires_for_build_wheel
          return self._get_build_requires(config_settings, requirements=['wheel'])
                 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "C:\Users\vocal\AppData\Local\Temp\pip-build-env-lr3fjsgg\overlay\Lib\site-packages\setuptools\build_meta.py", line 320, in _get_build_requires
          self.run_setup()
        File "C:\Users\vocal\AppData\Local\Temp\pip-build-env-lr3fjsgg\overlay\Lib\site-packages\setuptools\build_meta.py", line 485, in run_setup
          self).run_setup(setup_script=setup_script)
                ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        File "C:\Users\vocal\AppData\Local\Temp\pip-build-env-lr3fjsgg\overlay\Lib\site-packages\setuptools\build_meta.py", line 335, in run_setup
          exec(code, locals())
        File "<string>", line 13, in <module>
      UnicodeDecodeError: 'cp949' codec can't decode byte 0xe2 in position 1031: illegal multibyte sequence
      [end of output]

  note: This error originates from a subprocess, and is likely not a problem with pip.
error: subprocess-exited-with-error

× Getting requirements to build wheel did not run successfully.
│ exit code: 1
╰─> See above for output.

note: This error originates from a subprocess, and is likely not a problem with pip.

解决方案 #

方法1：临时强制UTF-8编码运行pip #

在CMD中执行：

set PYTHONUTF8=1
pip install openai

在PowerShell中执行：

$env:PYTHONUTF8=1
pip install openai

方法2：安装更高版本的openai #

旧版本0.26.0存在编码兼容问题，直接安装更新的稳定版本：

pip install openai>=1.0.0

方法3：永久设置系统UTF-8编码 #

1. 打开「控制面板」→「区域」
2. 切换到「管理」标签页，点击「更改系统区域设置」
3. 勾选「Beta版：使用Unicode UTF-8提供全球语言支持」
4. 重启电脑后再执行安装命令

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