在 PowerShell 中安装#
py -3.12 -m venv .venv
.venv\Scripts\Activate.ps1
python -m pip install -U pip
pip install docling # 国内可加 -i https://pypi.tuna.tsinghua.edu.cn/simple
docling --version如果激活时报错 “running scripts is disabled on this system”（在此系统上禁止运行脚本），为当前用户允许本地创建的脚本，然后再次激活：
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned在 cmd.exe 中请改用 .venv\Scripts\activate.bat。
NVIDIA 显卡#
nvidia-smi # 查看 "CUDA Version"
pip install torch torchvision --index-url https://download.pytorch.org/whl/cu132 # torch 2.15.0，驱动 CUDA ≥ 13.2；较旧驱动用 cu130 或 cu126（torch 2.14.1）
pip install docling
python -c "import torch; print(torch.cuda.is_available())"PyPI 上的 PyTorch Windows 安装包不依赖 NVIDIA 组件，因此直接 pip install docling 得到的是仅 CPU 的 PyTorch。先从 CUDA 索引安装才能启用 GPU。我们确认 cu132 和 cu134 上有 torch 2.15.0 的 Windows x86_64 版本；cu130 和 cu126 只到 2.14.1。
“docling 不是内部或外部命令”#
该命令位于 .venv\Scripts。激活虚拟环境，或直接调用模块——这种方式总是可用：
python -m docling.cli.main convert report.pdf --to mdOCR、Office 与音频工具#
| 需求 | 安装 | 告诉 Docling 它在哪里 |
|---|---|---|
| Tesseract 引擎 | Windows 版 Tesseract 安装程序，并勾选所需语言数据（中文为 chi_sim） | --ocr-option tesseract_cmd="C:\Program Files\Tesseract-OCR\tesseract.exe" |
| .doc / .ppt / .xls / .rtf | winget install TheDocumentFoundation.LibreOffice | 把 LibreOffice 的 program 目录加入 PATH，或把 DOCLING_LIBREOFFICE_CMD 设为 soffice.exe |
| 音频 / 视频 | winget install ffmpeg（Docling 报错信息中建议的命令） | 打开新终端以更新 PATH |
Hugging Face 缓存警告#
在未开启开发者模式的 Windows 上，huggingface_hub 可能警告其缓存无法使用符号链接。下载仍然正常，只是改为复制文件，占用更多磁盘空间。可以开启开发者模式，或用 HF_HOME 环境变量把缓存放到空间充足的磁盘上。无法访问 Hugging Face 时，可设置 HF_ENDPOINT 使用镜像。
WSL 与 Docker#
更喜欢 Linux 工具？在 WSL 2 中安装 Docling 的方式完全相同（见 Linux 指南），官方的 docling-serve 镜像也可以在 Docker Desktop 中运行。
常见问题
为什么 Windows 提示无法识别 docling 命令？
安装 Docling 的虚拟环境没有激活，或其 Scripts 文件夹不在 PATH 中。用 .venv\Scripts\activate 激活，或改用 python -m docling.cli.main。
如何在 Windows 上让 Docling 使用 NVIDIA 显卡？
在安装 Docling 之前先安装 CUDA 版 PyTorch，例如 pip install torch torchvision --index-url https://download.pytorch.org/whl/cu132（我们确认 cu132 和 cu134 上有 torch 2.15.0 的 Windows 版本，cu130 和 cu126 上有 2.14.1），然后检查 torch.cuda.is_available()。
如何在 Windows 上让 Docling 使用 Tesseract？
用 Windows 安装程序安装 Tesseract，然后把它的目录加入 PATH，或在 --ocr-engine tesseract 时传入 --ocr-option tesseract_cmd="C:\Program Files\Tesseract-OCR\tesseract.exe"。