Python 安装 fitz 提示 Module Not Found Error: No module named ‘pip‘_pip install fitz

MuPDF 是一个用 C 编写的开源 PDF 解析器和渲染器，而 PyMuPDF 是 MuPDF 的 Python 绑定，为在 Python 中对 MuPDF 库功能的访问提供交互接口，以允许开发者在 Python 环境中利用 MuPDF 的功能来处理和操作 PDF 文件。

MuPDF 的原始渲染库为 Libart。在 Artifex Software 收购了 MuPDF 项目之后，开发重点转移到了编写一个名为 “Fitz” 的新型现代图形库上。Fitz 最初是作为一个用来取代老化的 Ghostscript 图形库的研发项目，但最终成为了驱动 MuPDF 的渲染引擎。

一、修复 pip 安装

存在 Python2、 Python3 多版本的系统中需要指定版本环境，下文以系统中只有 Python3 为例

1、在 Python 3 ≥ 3.4 中

Microsoft Windows [版本 10.0.19045.2728]
(c) Microsoft Corporation。保留所有权利。
 
C:\WINDOWS\system32>python -m ensurepip
Installing collected packages: pip
Successfully installed pip-22.3

1
2
3
4
5
6
7

ensurepip 包支持将 pip 安装程序引导到现有的 Python 安装或虚拟环境中。

2、在 Python 3 ≤ 3.3 中

下载 get-pip.py 脚本 https://bootstrap.pypa.io/get-pip.py

打开终端命令提示符，到该文件的所在目录中运行：

 python get-pip.py
1

get-pip.py 也可以用于Python 3 ≥ 3.4 中。

修复 pip 使用 ensurepip 与 get-pip.py 的区别

1. ensurepip Python 3.4 及以上版本自带的一个模块，可以自动检测系统中是否存在 pip，如果不存在则会自动下载并安装。而 get-pip.py 需要先手动下载脚本文件，后运行该脚本文件来安装 pip。

2. ensurepip 和 get-pip.py 都可以安装当前 Python 版本默认的 pip 版本，但 ensurepip 不能直接安装特定的 pip 版本，而 get-pip.py 可以直接安装特定的 pip 版本。

使用以下命令来安装特定版本的 pip：

python get-pip.py==<version>
1

查看 pip 所对应的 Python 版本及所关联的Python解释器的路径

pip -V、pip --version、python -m pip -V、python -m pip --version 都可以查看版本

Microsoft Windows [版本 10.0.19045.2728]
(c) Microsoft Corporation。保留所有权利。

C:\WINDOWS\system32>pip -V
pip 22.3 from C:\Python311\Lib\site-packages\pip (python 3.12)

1
2
3
4
5
6

或 pip show pip 显示详细信息

C:\WINDOWS\system32>pip show pip
Name: pip
Version: 22.3
Summary: The PyPA recommended tool for installing Python packages.
Home-page: https://pip.pypa.io/
Author: The pip developers
Author-email: distutils-sig@python.org
License: MIT
Location: C:\Python311\Lib\site-packages
Requires:
Required-by:

1
2
3
4
5
6
7
8
9
10
11
12

更新 pip

pip install pip -U
1

如果直接更新 pip 不起作用，使用下列命令

C:\WINDOWS\system32>python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
Requirement already satisfied: pip in c:\python311\lib\site-packages (22.3)
Collecting pip
  Using cached pip-23.0.1-py3-none-any.whl (2.1 MB)
Installing collected packages: pip
  Attempting uninstall: pip
    Found existing installation: pip 22.3
    Uninstalling pip-22.3:
      Successfully uninstalled pip-22.3
Successfully installed pip-23.0.1

1
2
3
4
5
6
7
8
9
10
11

二、pip 源加速的两种方法

1、临时使用（pip 版本 ≥ 1.3）

pip install <package> -i https://pypi.tuna.tsinghua.edu.cn/simple
1

2、默认使用（pip 版本 ≥ 10.0，10.0 版本之前设置全局源 URL 需要手动编辑 pip 配置文件 ）

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
1

设置默认源 URL 后，安装包无需再带源 URL 直接使用

pip install <package> 
1

三、PyMuPDF 安装

方法 1：使用 pip 安装 PyMuPDF

C:\WINDOWS\system32>pip install PyMuPDF -i https://pypi.tuna.tsinghua.edu.cn/simple
Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple
Collecting PyMuPDF
  Downloading https://pypi.tuna.tsinghua.edu.cn/packages/aa/c0/2a7bfe118a5c965aa358da95fe77872d8d4fabadd14ed5f46a55b6ce7cc6/PyMuPDF-1.21.1-cp311-cp311-win_amd64.whl (11.7 MB)
     ---------------------------------------- 11.7/11.7 MB 203.3 kB/s eta 0:00:00
Installing collected packages: PyMuPDF
Successfully installed PyMuPDF-1.21.1 

1
2
3
4
5
6
7
8

• 安装指定版本

pip install PyMuPDF==<版本号>
1

查看 PyMuPDF，正常

pip show PyMuPDF
1

查看 fitz ，正常

C:\WINDOWS\system32>python
Python 3.11.0 (main, Oct 24 2022, 18:26:48) [MSC v.1933 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> help("fitz")
Help on package fitz:

NAME
    fitz

DESCRIPTION
...

1
2
3
4
5
6
7
8
9
10
11
12

导入 fitz ，正常

C:\WINDOWS\system32>python
Python 3.11.0 (main, Oct 24 2022, 18:26:48) [MSC v.1933 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> import fitz

1
2
3
4
5

方法 2： 使用 pip 安装 fitz

C:\WINDOWS\system32>pip install fitz -i https://pypi.tuna.tsinghua.edu.cn/simple
Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple
Collecting fitz
  Downloading 
     --------------------------------------
Installing collected packages: fitz

Successfully installed fitz-0.0.1.dev2

1
2
3
4
5
6
7
8
9

查看 fitz ，正常

C:\WINDOWS\system32>pip list
Package            Version
------------------ ----------
fitz               0.0.1.dev2

1
2
3
4
5

两种方法安装 fitz 的区别

• 无论是通过安装 PyMuPDF 安装 fitz，还是直接用 pip 安装 fitz，都可以正常使用 fitz 功能。

• 使用 pip 安装 fitz 只安装 fitz 本身，而不包括 PyMuPDF 模块的其他功能。而安装 PyMuPDF 模块会自动安装 fitz ，可以使用 PyMuPDF 模块包括 fitz 的所有功能。

• 如果用 pip uninstall 卸载 pip 安装的 fitz，会把 PyMuPDF 包组件中 fitz 一并删除，实际上两种安装方式 fitz 都在同一目录。

fitz 更新

pip install --upgrade PyMuPDF
1

如果 --upgrade 不起作用，也可以通过--force-reinstall 重装 PyMuPDF 来完成

C:\WINDOWS\system32>pip install --force-reinstall PyMuPDF -i https://pypi.tuna.tsinghua.edu.cn/simple
Looking in indexes: https://pypi.tuna.tsinghua.edu.cn/simple
Collecting PyMuPDF
  Using cached https://pypi.tuna.tsinghua.edu.cn/packages/aa/c0/2a7bfe118a5c965aa358da95fe77872d8d4fabadd14ed5f46a55b6ce7cc6/PyMuPDF-1.21.1-cp311-cp311-win_amd64.whl (11.7 MB)
Installing collected packages: PyMuPDF
  Attempting uninstall: PyMuPDF
    Found existing installation: PyMuPDF 1.21.1
    Uninstalling PyMuPDF-1.21.1:
      Successfully uninstalled PyMuPDF-1.21.1
Successfully installed PyMuPDF-1.21.1

1
2
3
4
5
6
7
8
9
10
11

再次查看 fitz，正常

C:\WINDOWS\system32>python
Python 3.11.0 (main, Oct 24 2022, 18:26:48) [MSC v.1933 64 bit (AMD64)] on win32
Type "help", "copyright", "credits" or "license" for more information.
>>> help("fitz")
Help on package fitz:

NAME
    fitz

DESCRIPTION
...

1
2
3
4
5
6
7
8
9
10
11
12

四、PyMuPDF 使用文档

PyMuPDF Documentation

https://buildmedia.readthedocs.org/media/pdf/pymupdf/latest/pymupdf.pdf

本文属于作者原创，转载请注明出处。