DeepSeek安装失败主因是PyPI默认源不兼容国内网络及依赖包大、版本紧耦合，解决方法包括：一、切换pip全局镜像源；二、临时指定镜像源安装；三、替换为阿里云镜像源；四、离线预下载依赖；五、强制指定兼容版本。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在安装DeepSeek时频繁遭遇依赖包下载失败、超时中断或ConnectionResetError等错误，则很可能是PyPI默认源未适配国内网络环境，且DeepSeek相关依赖（如flash-attn、vLLM、transformers）体积大、版本耦合紧。以下是解决此问题的步骤：
一、切换pip全局镜像源
该方法通过修改pip配置，使所有后续install命令自动走国内CDN节点，避免逐条命令重复指定源，适用于系统级长期使用。
1、在Windows系统中，打开文件资源管理器，进入路径：%USERPROFILE%\pip\pip.ini（若pip文件夹不存在，请手动创建）。
2、用记事本新建pip.ini文件，在其中写入以下内容：
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple/
trusted-host = pypi.tuna.tsinghua.edu.cn
3、保存文件后，在命令行中执行pip config list，确认输出包含index-url配置项。
二、临时指定镜像源安装依赖
该方法不修改系统配置，适合单次部署或多人共享环境，可精准控制每个安装动作的源地址，规避全局配置冲突风险。
1、进入DeepSeek项目根目录（如DeepSeek-OCR或deepseek-r1所在文件夹）。
2、执行以下命令，跳过依赖自动解析，仅安装当前包结构：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ --no-deps -e .
3、再单独安装requirements.txt中声明的全部依赖：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ -r requirements.txt
三、使用阿里云镜像源替代清华源
当清华源偶发响应延迟或限流时，阿里云镜像站具备更高并发承载能力与更稳定的DNS解析，特别适合批量部署场景。
1、临时替换为阿里云源，执行安装命令：
pip install -i https://mirrors.aliyun.com/pypi/simple/ -r requirements.txt
统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。
2、若需永久切换，将pip.ini中index-url行改为：
index-url = https://mirrors.aliyun.com/pypi/simple/
3、同步更新trusted-host为：mirrors.aliyun.com
四、离线预下载依赖并本地安装
该方法适用于内网隔离环境或反复重试失败的高敏感生产系统，通过提前在外网机器下载完整wheel包集合，彻底规避实时网络请求。
1、在联网机器上创建临时目录，执行依赖预下载：
pip download -i https://pypi.tuna.tsinghua.edu.cn/simple/ -r requirements.txt --no-deps -d ./wheels
2、将整个wheels文件夹拷贝至目标部署机对应路径。
3、在目标机执行本地安装（不联网）：
pip install --find-links ./wheels --no-index -r requirements.txt
五、强制指定兼容版本配合镜像源
部分报错源于flash-attn或torch版本不匹配引发的编译失败，此时需锁定已验证组合，并通过镜像源加速获取。
1、卸载现有torch与flash-attn：
pip uninstall torch flash-attn -y
2、使用清华源安装DeepSeek-OCR-2实测兼容版本：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ torch==2.3.1+cu118 torchvision==0.18.1+cu118 --extra-index-url https://download.pytorch.org/whl/cu118
3、再安装flash-attn 2.6.3（支持CUDA 11.8且无需编译）：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple/ flash-attn==2.6.3 --no-build-isolation
