faceai 依赖安装提速:Windows 下 pip/pip3 更换国内镜像源完整指南

发布时间:2026/9/23 19:32:35
faceai 依赖安装提速:Windows 下 pip/pip3 更换国内镜像源完整指南 计算机视觉人工智能深度学习【免费下载链接】faceai一款入门级的人脸、视频、文字检测以及识别的项目.项目地址https://gitcode.com/gh_mirrors/fa/faceai点击查看免费下载本文面向 Windows 用户完整讲解如何将 pip/pip3 默认的官方 PyPI 源切换为国内镜像源以清华源为主附阿里云、中科大、豆瓣等备选从而显著提升 Python 包下载速度与安装成功率。该教程对应本仓库 doc/pipChange.md 文档并结合 README.md 中的项目依赖环境与 doc/settingup.md 的安装流程展开读完即可上手配置并验证生效。为什么本项目强烈建议先换国内源faceai 是一个入门级的人脸、视频、文字检测与识别项目其运行依赖多个体积庞大、依赖链复杂的 Python 包。从项目 README.md 的开发环境一节可以看到官方开发环境包含Python 3.6.4OpenCV 3.4.1Dlib 19.8.1face_recognition 1.2.2keras 2.1.6tensorflow 1.8.0Tesseract OCR 4.0.0-beta.1其中 tensorflow、opencv-python、dlib 等包动辄几十到上百 MB且依赖 numpy 等基础库。若使用 pip 默认指向的官方 PyPI 源服务器位于国外在国内网络环境下极易出现下载超时、连接中断、安装失败等情况而将源更换为国内镜像后下载速度与成功率都会大幅提升——这正是 doc/pipChange.md 开篇所述大大的提高安装成功率和速度的直接原因。在 doc/settingup.md 中演示的pip3 install d:\opencv_python-3.4.1-cp36-cp36m-win_amd64.whl这类安装场景同样受益于一个稳定快速的源。Windows 更换 pip/pip3 源的完整步骤原文档给出了三步配置法下面逐条展开注意无论你使用的是 pip 还是 pip3方法完全一样都是创建同一个 pip 文件夹和配置文件因为 pip 与 pip3 读取的是同一份用户级配置。第 1 步打开%appdata%目录在 Windows 的运行对话框Win R中输入%appdata%回车后即打开用户漫游数据目录实际路径通常为C:\Users\你的用户名\AppData\Roamingpip 的用户级配置文件就存放在该目录下的pip子文件夹中。第 2 步新增 pip 文件夹并新建 pip.ini 文件在%appdata%目录下新建一个名为pip的文件夹若已存在则直接进入然后在pip文件夹内新建一个文本文件并将其命名为pip.ini。请务必确认扩展名为.ini而不是pip.ini.txt——建议在资源管理器中开启显示文件扩展名后再重命名否则配置不会被 pip 读取。最终目录结构如下C:\Users\你的用户名\AppData\Roaming\pip\pip.ini第 3 步向 pip.ini 写入国内源配置用记事本等编辑器打开pip.ini粘贴以下内容并保存以下为 doc/pipChange.md 原文给出的配置[global] timeout 6000 index-url https://pypi.tuna.tsinghua.edu.cn/simple trusted-host pypi.tuna.tsinghua.edu.cn保存完成后pip/pip3 后续的所有安装操作都会自动走清华镜像源。原文档特别说明清华源每5 分钟与官方 PyPI 同步一次同步频率高、包比较新因此是文档首推的源。pip.ini 配置项逐项解读为了让配置知其然也知其所以然结合 pip 的配置机制对各参数说明如下配置项示例值作用[global]—配置段标记表示以下配置对所有 pip 命令全局生效timeout6000设置 pip 请求 PyPI 的超时时间单位为秒增大该值可避免网络抖动导致的下载中断index-urlhttps://pypi.tuna.tsinghua.edu.cn/simple指定包索引源的地址即 pip 搜索和下载包的服务器这是换源的核心配置trusted-hostpypi.tuna.tsinghua.edu.cn将该主机标记为受信任主机跳过其 HTTPS 证书校验或 http 源的安全告警避免安装过程中弹出不受信任的警告甚至被拦截需要特别注意的是当index-url指向的是http://非 https源时例如下文列表中的阿里云、豆瓣trusted-host几乎是必须同步配置的否则 pip 默认拒绝从不安全的源安装包。本仓库 doc/ubuntuChange.md 中 Linux 版配置~/.pip/pip.conf也遵循完全相同的[global]index-urltrusted-host三段式结构可以相互印证。验证配置是否生效配置完成后建议通过以下方式确认源已切换成功查看 pip 版本与配置文件位置在命令行中执行pip -V pip3 -V输出中会附带显示当前读取的配置文件路径若能看到C:\Users\用户名\AppData\Roaming\pip\pip.ini说明配置文件已被正确加载。列出当前生效配置执行pip config list若输出中包含global.index-urlhttps://pypi.tuna.tsinghua.edu.cn/simple即表示配置生效。实测安装速度执行一次实际安装验证例如pip install numpy观察下载速度与日志中的源地址速度明显提升且不再超时即说明换源成功。随后即可按 doc/settingup.md 的流程安装 numpy、opencv-python 等项目依赖以及 README 中列出的 dlib、face_recognition、keras、tensorflow 等包。国内镜像源列表与选择建议以下是 doc/pipChange.md 原文列出的国内源完整清单镜像源地址清华大学https://pypi.tuna.tsinghua.edu.cn/simple/阿里云http://mirrors.aliyun.com/pypi/simple/中国科技大学USTChttps://pypi.mirrors.ustc.edu.cn/simple/豆瓣doubanhttp://pypi.douban.com/simple/中国科学技术大学USTChttp://pypi.mirrors.ustc.edu.cn/simple/选择建议清华源为首选原文档明确说明清华的源 5 分钟同步官网一次建议使用同步及时、稳定性好注意列表中的重复项原文档中中国科技大学与中国科学技术大学实际上是同一机构USTC的镜像只是分别给出了 https 与 http 两种协议地址使用时任选其一即可http 源务必配置 trusted-host上表中的阿里云与豆瓣均为http://协议切换这两个源时需将trusted-host同步改为对应主机名如mirrors.aliyun.com否则安装可能被安全机制拦截。不修改配置文件也能用国内源的补充方式除了上文写入pip.ini的永久配置pip 还支持以下临时或命令级换源方式适合单次安装或不想改动全局配置的场景这些属于 pip 的标准功能可作为原文档方案的补充命令行-i参数单次生效pip install opencv-python -i https://pypi.tuna.tsinghua.edu.cn/simple仅对当前这条命令生效不写入任何配置文件。环境变量会话级生效设置环境变量PIP_INDEX_URL指向镜像地址后当前终端会话内的所有 pip 操作都会使用该源。pip config set命令等效于改配置文件pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple该命令会自动将配置写入用户级配置文件效果与手动编辑pip.ini一致且无需手工创建目录。LinuxUbuntu用户怎么办本文档针对 Windows 版本。如果你使用的是 Ubuntu 等 Linux 发行版配置方式不同pip 配置文件位于~/.pip/pip.conf且通常还需要一并更换apt-get软件源详见同仓库的 Ubuntu apt-get 和 pip 源更换 文档其中包含了pip3的安装升级、pip 源更换以及默认 Python 版本切换等完整步骤。该文档与本篇在 README.md 的其他教程章节中并列列出两者配合即可覆盖 Windows 与 Linux 两大主流开发环境为顺利搭建 faceai 项目OpenCV、Dlib、face_recognition、keras、tensorflow 等依赖扫清下载层面的障碍。赞分享计算机视觉人工智能深度学习【免费下载链接】faceai一款入门级的人脸、视频、文字检测以及识别的项目.项目地址https://gitcode.com/gh_mirrors/fa/faceai点击查看免费下载相关推荐终极Leiningen镜像配置指南加速国内Clojure开发的完整方案终极Leiningen镜像配置指南加速国内Clojure开发的完整方案 Leiningen作为Clojure生态系统中最流行的构建工具其依赖下载速度直接影响构建工具CLIIPython 安装完全指南pip 快速安装、依赖解析与开发版源码安装IPython 安装完全指南pip 快速安装、依赖解析与开发版源码安装 IPython 是面向交互式计算的高级 Python 命令 Shell本文以官方安装开发工具CLI40分钟跑通WVP-GB28181-Pro国标视频平台从容器部署到分屏监控全记录40分钟跑通WVP GB28181 Pro国标视频平台从容器部署到分屏监控全记录 WVP GB28181 Pro 是基于 GB/T 28181 2016 与部后端音视频前端上一篇Qwen3-30B-A3B评估指标解析困惑度与BLEU分数背后的模型质量下一篇Clover社区指南如何参与开源项目讨论与问题反馈创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考