使用 uv 临时指定豆瓣源,只需在命令后追加 --index-url https://pypi.douban.com/simple 参数即可。该参数会覆盖默认配置,仅对当前执行的单次命令生效,不会影响后续操作或全局设置。

如何验证临时源是否生效
要确认临时源已正确应用,可以在执行安装或同步命令时添加 -v(verbose)参数。开启详细模式后,终端输出会显示实际请求的 URL,若看到地址以 pypi.douban.com 开头,即表示临时源已生效。

uv pip install requests -v --index-url https://pypi.douban.com/simple
临时源与全局配置的优先级关系
当同时存在命令行参数和配置文件中的源设置时,命令行指定的 --index-url 具有最高优先级。这意味着即使你在 uv.toml 或环境变量中配置了其他镜像源,只要加上临时参数,uv 就会优先使用命令行提供的地址进行包查找。
立即学习“Python免费学习笔记(深入)”;

# uv.toml 内容 [[index]] url = "https://pypi.org/simple" # 执行命令 uv pip install flask --index-url https://pypi.douban.com/simple
基于具体输入条件的源选择结果
如果输入的包名在豆瓣源中不存在,但在全局源中存在,临时指定豆瓣源会导致安装失败并抛出 No matching distribution 错误。这是因为 uv 在临时模式下严格遵循指定的索引地址,不会自动回退到其他源,除非显式配置了多索引回退机制。


















