pip安装时UnicodeDecodeError: 'gbk' codec can't decode byte 0x80 in position 64: illegal multibyte sequence
时间: 2025-01-30 07:12:37 浏览: 111
### 解决 pip 安装时出现的 `UnicodeDecodeError` 错误
在 Windows 平台上使用 Python 进行开发时,可能会遇到由于字符编码不兼容而导致的 `UnicodeDecodeError` 错误。具体表现为尝试通过 pip 安装软件包时遇到了 `'gbk' codec can't decode byte` 的异常情况。
#### 方法一:临时修改命令提示符中的环境变量
可以在每次执行 pip 命令之前,在命令行中设置特定的环境变量来强制 Python 使用 UTF-8 编码:
```bash
set PYTHONUTF8=1
pip install <package_name>
```
这种方法仅影响当前会话内的操作,并不会永久更改系统的配置[^2]。
#### 方法二:更新 PyCharm 中的 Pip 版本并指定索引源
如果是在 PyCharm IDE 内部工作,则可以考虑升级内置的 pip 工具到最新版本,并且切换至国内更稳定的镜像服务器以减少网络因素带来的干扰:
```bash
python -m pip install --upgrade pip -i https://pypi.douban.com/simple
```
完成上述步骤之后再次尝试安装所需的库文件应该能够有效规避原有的解码失败问题[^4]。
#### 方法三:全局调整 Python 默认编码方式
对于希望彻底解决问题而不必每次都手动设定的情况来说,可以通过增加系统级别的环境变量实现长期有效的解决方案。即创建一个新的名为 `PYTHONUTF8` 的环境变量并将它的值设为 `1` 。此改动会使所有的 Python 实例默认采用 UTF-8 来解析字符串输入输出流[^5]。
---
阅读全文
相关推荐


















