uv怎么恢复默认的依赖源

夏辰吖_4342

夏辰吖_4342

2026-10-15

715人浏览

原创

应恢复uv默认官方源(https://pypi.org/simple/),方法包括:删除shell配置中uv_index环境变量、清空~/.config/uv/config.toml文件,或临时用uv_index=...命令覆盖。

uv怎么恢复默认的依赖源 - php中文网

当你在使用 uv 安装 Python 包时发现依赖下载缓慢、超时或返回 404,很可能是之前手动配置了非官方 PyPI 镜像源(如阿里云、清华源)且当前镜像已失效或路径不兼容,需要恢复到 uv 默认的官方 PyPI 源(https://pypi.org/simple/)。

确认当前是否启用了自定义依赖源

运行以下命令查看 uv 当前实际使用的 index 地址:

uv python list --verbose 或 uv pip install --dry-run requests 2>&1 | grep "index"

如果输出中出现 https://mirrors.aliyun.com/pypi/simple/ 或类似非 pypi.org 的域名,说明当前正使用自定义源。

删除环境变量方式设置的 UV_INDEX

检查是否通过 export UV_INDEX=... 在 shell 启动文件中硬编码设置了源:

执行 grep -n "UV_INDEX" ~/.bashrc ~/.zshrc ~/.profile 2>/dev/null

若返回匹配行,用文本编辑器打开对应文件(如 nano ~/.bashrc),定位并删除整行 export UV_INDEX="...",保存退出。

【注意:不要只注释掉,必须彻底删除该行;否则每次 shell 启动仍会加载旧源】

然后重新加载配置:source ~/.bashrc(或对应 shell 配置文件)。

清除 config.toml 中的 index 配置

uv 优先读取 ~/.config/uv/config.toml 中的全局设置。若该文件存在且包含 [pip] 或 index-url 字段,需清空或修正。

第一步:检查文件是否存在并查看内容
cat ~/.config/uv/config.toml 2>/dev/null || echo "config.toml 不存在"

第二步:若存在且含自定义 index,直接清空该文件(uv 启动时无配置即自动回退至默认源):
truncate -s 0 ~/.config/uv/config.toml

第三步:验证是否生效 —— 运行 uv pip install --dry-run requests,观察日志中 index-url 是否已变为 https://pypi.org/simple/。

强制跳过所有配置,临时使用默认源

方法一:单次命令覆盖
UV_INDEX=https://pypi.org/simple/ uv pip install requests

方法二:禁用全部配置文件与环境变量
UV_CONFIG_FILE=/dev/null UV_INDEX= uv pip install requests

这一步能快速验证默认源是否可连通。若成功安装,说明网络和官方源正常,问题确系本地配置导致。

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

2910

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

6663

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

8262

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

4147

16

Python uv使用教程
Python uv使用教程

本专题汇总了 Python uv 使用教程与高效使用指南,从 uv 安装配置、常用命令到虚拟环境、依赖管理与项目打包,系统讲解如何用 uv 替代 pip 与 poetry,全面提升 Python 项目开发效率,助你快速上手这一现代化包管理工具,打造干净高效的 Python 工作流。

2026.10.15

0

15

剧云AI短剧创作教程合集
剧云AI短剧创作教程合集

本专题聚焦剧云AI短剧创作,讲解从短剧灵感、梗概、全局大纲到分集、分场和正文的完整流程及节奏设计方法。

2026.10.14

0

15

剧云AI剧本创作零基础入门
剧云AI剧本创作零基础入门

本专题系统讲解剧云AI剧本创作流程,涵盖灵感、梗概、大纲、分场与正文生成,帮助新手快速完成首个中文剧本项目。

2026.10.14

0

14

VibeKnow文档转视频操作指南
VibeKnow文档转视频操作指南

本专题讲解VibeKnow上传Word、TXT、Markdown等材料生成视频的方法,覆盖内容解析、脚本组织、画面生成与成片检查。

2026.10.14

0

15

VibeKnow知识视频制作与导出详解
VibeKnow知识视频制作与导出详解

本专题整理VibeKnow从注册、素材上传、AI生成到预览导出的完整操作,帮助新手快速制作第一条知识讲解视频。

2026.10.14

0

13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
phpStudy极速入门视频教程
phpStudy极速入门视频教程

共6课时 | 54.7万人学习

独孤九贱(4)_PHP视频教程
独孤九贱(4)_PHP视频教程

共89课时 | 133.7万人学习