pip – Jeff Notes

在 Debian 12 上安装 pdf2docx，可以通过 Python 的包管理工具 pip 来安装。为了避免影响系统的环境，建议在一个 Python 虚拟环境中安装该工具。下面是详细的安装步骤：

首先，确保你的系统已经安装了 Python 3 和 pip。可以通过以下命令检查：

python3 --version
pip3 --version

如果没有安装，可以通过以下命令安装：

sudo apt update
sudo apt install python3 python3-pip

2. 创建 Python 虚拟环境

虚拟环境可以隔离不同项目所需的依赖包。创建虚拟环境的步骤如下：

python3 -m venv myenv

这将创建一个名为 myenv 的虚拟环境，所有的包将会安装在这个目录下，而不会影响系统环境。

要使用虚拟环境中的 Python 和 pip，你需要先激活它。使用以下命令来激活虚拟环境：

source myenv/bin/activate

激活后，你的终端提示符会发生变化，通常会看到虚拟环境的名称（myenv）出现在命令行前缀处，表明你当前处于该虚拟环境中。

在虚拟环境中，你可以使用 pip 安装 pdf2docx：

pip install pdf2docx

安装完成后，pdf2docx 将只会安装在 myenv 目录下，而不会影响系统环境。

安装完成后，你就可以在虚拟环境中使用 pdf2docx 进行 PDF 转 DOCX 的转换了。例如，使用以下命令：

from pdf2docx import Converter

cv = Converter('input.pdf')
cv.convert('output.docx', start=0, end=None)
cv.close()

6. 退出虚拟环境

当你完成工作后，可以通过以下命令退出虚拟环境：

deactivate

这样，你就成功在 Debian 12 上通过 pip 安装了 pdf2docx，并且使用了 Python 虚拟环境来隔离依赖，避免对系统环境的影响。

在 Debian 12 上，pip 默认使用的是官方的 Python 包索引（PyPI），但由于网络原因，访问可能会较慢。为了提高下载速度，可以更换为国内的镜像源。

如果只是临时使用国内源，可以在安装 Python 包时添加 -i 参数。例如：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple somepackage

为了让 pip 默认使用国内源，可以修改用户级别的配置文件，推荐使用以下方法：

mkdir -p ~/.config/pip

echo "[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple" > ~/.config/pip/pip.conf

这样 pip 以后都会默认使用清华源，无需每次手动指定。

如果希望所有用户都使用国内源，可以修改全局配置文件：

sudo mkdir -p /etc/pip

echo "[global] index-url = https://pypi.tuna.tsinghua.edu.cn/simple" | sudo tee /etc/pip/pip.conf

这种方式会影响系统中所有用户的 pip 配置。

除了清华 TUNA 源，还可以选择其他国内镜像源，例如：

可以根据个人网络情况选择合适的源。

可以运行以下命令检查当前 pip 使用的源：

pip config list

如果输出中包含 index-url = https://pypi.tuna.tsinghua.edu.cn/simple，说明配置已经生效。

这样就可以更快地安装 Python 包，提高开发效率！

标签： pip