[教程TUTORIAL] DeepSeek-OCR Windows WSL本地安装部署避坑指南 Local Installation and Deployment Guide for Windows WSL

由于官方安装非常具有误导性，并且存在自相矛盾的情况，特意根据自己踩过的坑写了这个指南。

#5

#39

#49

#77

#89

#94

#126

#302

#307

最核心的关键是：

不要遵照官方的安装流程执行安装，那仅适用于当时的版本状况，尤其

• 不要以指定版本方式安装torch
• 不要以指定版本方式安装vllm
• 不要安装任何版本flash-attn
• 不要安装requiements.txt依赖包

当前使用以下方法安装才是最佳实践

# 官方秘诀出处：https://docs.vllm.ai/projects/recipes/en/latest/DeepSeek/DeepSeek-OCR.html
uv pip install -U vllm --torch-backend auto

完整中文版本在此：

DeepSeek-OCR Windows WSL本地安装部署指南

https://github.com/k6G52m4Dz75W/VisualFrontier/blob/main/DeepSeek-OCR/DeepSeek-OCR_Local_Installation_and_Deployment_Guide_for_Windows_WSL.md

Full English version here:

Local Installation and Deployment Guide for Windows WSL

https://github.com/k6G52m4Dz75W/VisualFrontier/blob/main/DeepSeek-OCR/DeepSeek-OCR_Local_Installation_and_Deployment_Guide_for_Windows_WSL.en.md