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

当你在使用 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
这一步能快速验证默认源是否可连通。若成功安装,说明网络和官方源正常,问题确系本地配置导致。










