Python安装bokeh库出错导致pip无法运行问题求助

问题报错详情 #

安装bokeh库时pip崩溃，运行任意pip命令均抛出如下错误：

Traceback (most recent call last):
File "c:\users\s\appdata\local\programs\python\python39\lib\runpy.py", line 197, in _run_module_as_main
return _run_code(code, main_globals, None,
  File "c:\users\s\appdata\local\programs\python\python39\lib\runpy.py", line 87, in _run_code
exec(code, run_globals)
File "C:\Users\S\AppData\Local\Programs\Python\Python39\Scripts\pip.exe\__main__.py", line 4, in <module>
File "c:\users\s\appdata\local\programs\python\python39\lib\site-packages\pip\_internal\cli\main.py", line 9, in <module>
from pip._internal.cli.autocompletion import autocomplete
File "c:\users\s\appdata\local\programs\python\python39\lib\site-packages\pip\_internal\cli\autocompletion.py", line 10, in <module>
from pip._internal.cli.main_parser import create_main_parser
File "c:\users\s\appdata\local\programs\python\python39\lib\site-packages\pip\_internal\cli\main_parser.py", line 8, in <module>
from pip._internal.cli import cmdoptions
File "c:\users\s\appdata\local\programs\python\python39\lib\site-packages\pip\_internal\cli\cmdoptions.py", line 21, in <module>
from pip._vendor.packaging.utils import canonicalize_name
ValueError: 源代码字符串不能包含空字节

根因说明 #

该报错是pip依赖的packaging工具库的核心文件写入损坏，存在非法空字节导致加载失败，通常由之前安装包时网络中断、磁盘写入异常、杀毒软件误拦截导致。

解决方案 #

• 第一步：使用Python内置的ensurepip模块修复损坏的pip，直接在命令行执行以下命令，不需要调用现有pip进程：

python -m ensurepip --upgrade

• 第二步：验证pip修复结果，执行：

pip --version

正常输出版本号即代表修复完成。

• 第三步：重新安装bokeh库：

pip install bokeh

• 异常兜底方案：如果上述修复无效，直接覆盖安装同版本的Python，安装时选择保留现有配置，该操作不会删除已安装的第三方库，只会修复损坏的Python核心组件与pip相关文件。

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