Python 3.8.8 环境下离线安装 python-docx 的完整方案

方案一：手动下载 whl 文件（推荐）

1. 下载离线安装包

先在有网络的电脑上下载：

# 下载 python-docx 及其依赖包
pip download python-docx -d ./offline_packages --platform win_amd64 --python-version 38 --only-binary=:all:

或者手动下载这些文件：

• python-docx: https://files.pythonhosted.org/packages/…/python-docx-1.1.0-py3-none-any.whl
• 依赖包：
  • lxml (4.9.3)
  • Pillow (10.3.0)
  • typing-extensions (4.9.0)

2. 离线安装步骤

将下载的文件复制到离线环境，然后执行以下命令：

# 1. 先安装依赖包（按顺序）
pip install lxml-4.9.3-cp38-cp38-win_amd64.whl
pip install Pillow-10.3.0-cp38-cp38-win_amd64.whl

# 2. 安装 python-docx
pip install python_docx-1.1.0-py3-none-any.whl

方案二：下载源码包安装

1. 下载源码包

访问 https://pypi.org/project/python-docx/#files 下载：

• python-docx-1.1.0.tar.gz

同时下载依赖包源码：

• lxml: https://pypi.org/project/lxml/
• Pillow: https://pypi.org/project/Pillow/

2. 离线安装

# 解压并安装
tar -xzf python-docx-1.1.0.tar.gz
cd python-docx-1.1.0

# 安装依赖（如果有 whl 文件优先用 whl）
pip install ../lxml-4.9.3.tar.gz
pip install ../Pillow-10.3.0.tar.gz

# 安装 python-docx
pip install .

方案三：完整依赖包下载脚本

创建一个下载脚本 download_packages.py：

import os
import subprocess

packages = ['lxml==4.9.3', 'Pillow==10.3.0', 'python-docx==1.1.0']

# 创建目录
os.makedirs('offline_packages', exist_ok=True)

# 下载所有包
for package in packages:
    cmd = f'pip download {package} -d ./offline_packages --platform win_amd64 --python-version 38'
    subprocess.call(cmd)

方案四：使用 pypi-mirror 工具

如果有另一台联网电脑：

# 1. 创建本地镜像
pip install pypi-mirror
pypi-mirror download -d ./mirror python-docx lxml Pillow

# 2. 复制 mirror 文件夹到离线环境

# 3. 离线安装
pip install --no-index --find-links=./mirror python-docx

快速验证安装

安装成功后，创建一个测试文件 test_docx.py：

from docx import Document

# 创建一个新文档
doc = Document()
doc.add_paragraph('Hello, python-docx!')

# 保存文档
doc.save('test_document.docx')
print("python-docx 安装成功！")

运行测试：

python test_docx.py

常见问题解决

1. 平台不匹配：

   • 确保下载的 whl 文件包含 cp38（Python 3.8）
   • 32 位系统用 win32，64 位系统用 win_amd64

2. 依赖冲突：

# 强制安装指定版本
pip install package_name --no-deps

3. 安装 lxml 失败：

# 尝试先安装 wheel
pip install wheel
# 或者下载对应版本的 lxml

建议

1. 推荐使用方案一，下载 whl 文件最稳定。

如果遇到问题，可以尝试更新 pip：

python -m pip install --upgrade pip

确保离线环境的 Python 版本确实是 3.8.8：

python --version

按照这些步骤，您应该能在 Python 3.8.8 环境下成功离线安装 python-docx。