Jupyter Notebook中pip无法安装python-pptx的解决方法

场景说明 #

开发PPT内容提取功能需依赖python-pptx包，实现PowerPoint幻灯片内容导出到文本文件的需求。在Jupyter Notebook单元格执行安装命令!pip install python-pptx时触发报错，报错信息如下：

排查与解决步骤 #

• 优先排查Jupyter内核与pip的环境匹配问题
  多数Notebook内安装失败的核心原因是!pip调用的pip程序不属于当前运行Notebook的Python环境。先在单元格执行以下代码获取当前内核绑定的Python解释器绝对路径：

  import sys
  print(sys.executable)
  

  拿到路径后，用「解释器绝对路径 -m pip install」的格式执行安装，例如返回路径为C:\Users\XXX\miniconda3\envs\dev\python.exe，则对应安装命令为：

  !C:\Users\XXX\miniconda3\envs\dev\python.exe -m pip install python-pptx
  

  该方式可以彻底规避多Python环境下的安装错位问题。
• 排查网络与源的问题
  如果报错包含timeout、connection refused类提示，属于PyPI官方源访问不稳定导致的安装失败，直接切换国内镜像源执行安装即可：

  !pip install python-pptx -i https://pypi.tuna.tsinghua.edu.cn/simple
  

  执行前可以先升级pip版本降低兼容问题概率：!pip install --upgrade pip
• 排查权限问题
  如果报错包含Permission denied字段，说明当前账号对Python环境的site-packages目录没有写入权限，添加--user参数执行用户级安装即可，不要使用sudo提权安装，避免污染系统全局环境：

  !pip install --user python-pptx
  

• 排查缓存损坏问题
  如果报错提示文件校验失败、包损坏，先清空本地pip缓存后执行无缓存安装：

  !pip cache purge
  !pip install --no-cache-dir python-pptx
  

• 安装结果验证
  安装完成后在单元格执行import pptx，执行无报错即代表安装成功，可正常开展幻灯片内容提取功能的开发。

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