我将为您提供在Python 3.8.8环境下离线安装python-docx的完整方案:
方案一:手动下载whl文件(推荐)
1. 下载离线安装包
先在有网络的电脑上下载:
bash
# 下载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. 离线安装步骤
将下载的文件复制到离线环境,然后:
bash
# 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
同时下载依赖包源码:
2. 离线安装
bash
# 解压并安装
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:
python
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工具
如果有另一台联网电脑:
bash
# 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:
python
from docx import Document
# 创建一个新文档
doc = Document()
doc.add_paragraph('Hello, python-docx!')
# 保存文档
doc.save('test_document.docx')
print("python-docx 安装成功!")
运行测试:
bash
python test_docx.py
常见问题解决
-
安装lxml失败:
bash# 尝试先安装wheel pip install wheel # 或者下载对应版本的lxml -
平台不匹配:
- 确保下载的whl文件包含
cp38(Python 3.8) - 32位系统用
win32,64位系统用win_amd64
- 确保下载的whl文件包含
-
依赖冲突:
bash# 强制安装指定版本 pip install package_name --no-deps
建议
-
推荐使用方案一,下载whl文件最稳定
-
确保离线环境的Python版本确实是3.8.8:
bashpython --version -
如果遇到问题,可以尝试更新pip:
bashpython -m pip install --upgrade pip
按照这些步骤,您应该能在Python 3.8.8环境下成功离线安装python-docx。