方案一:手动下载 whl 文件(推荐)
1. 下载离线安装包
先在有网络的电脑上下载:
# 下载 python-docx 及其依赖包
pip download python-docx -d ./offline_packages --platform win_amd64 --python-version 38 --only-binary=:all:
或者手动下载这些文件:
- python-docx:
在 Python 3.8.8 环境下离线安装 python-docx 库的多种方案。主要方法包括手动下载 whl 文件、源码包安装、脚本批量下载及使用 pypi-mirror 工具。重点强调了依赖包(如 lxml、Pillow)的顺序安装及版本匹配问题。通过创建测试文档验证安装结果,并提供了常见问题解决建议,确保在无网络环境中成功部署。
先在有网络的电脑上下载:
# 下载 python-docx 及其依赖包
pip download python-docx -d ./offline_packages --platform win_amd64 --python-version 38 --only-binary=:all:
或者手动下载这些文件:
将下载的文件复制到离线环境,然后执行以下命令:
# 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
python-docx-1.1.0.tar.gz同时下载依赖包源码:
# 解压并安装
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)
如果有另一台联网电脑:
# 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
平台不匹配:
cp38(Python 3.8)win32,64 位系统用 win_amd64依赖冲突:
# 强制安装指定版本
pip install package_name --no-deps
# 尝试先安装 wheel
pip install wheel
# 或者下载对应版本的 lxml
如果遇到问题,可以尝试更新 pip:
python -m pip install --upgrade pip
确保离线环境的 Python 版本确实是 3.8.8:
python --version
按照这些步骤,您应该能在 Python 3.8.8 环境下成功离线安装 python-docx。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
解析常见 curl 参数并生成 fetch、axios、PHP curl 或 Python requests 示例代码。 在线工具,curl 转代码在线工具,online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online