PyPI 插件使用指南

中文 | English

• PyPI 插件使用指南
  • 简介
  • 安装
  • 使用
    • 基本命令
    • 命令详情
    • 例子
  • 支持的镜像
  • 注意事项
  • 帮助
  • License

简介

这是一个用于管理 PyPI 镜像的 oh-my-zsh 插件。该插件提供了几个便捷的命令，允许用户列出可用的 PyPI 镜像、切换 pip 和 uv 的镜像，以及测试镜像的网络连通性。

安装

使用git

git clone https://github.com/belingud/pypi ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/pypi

或者将插件脚本手动复制到 ~/.oh-my-zsh/custom/plugins/ 目录下，然后在 ~/.zshrc 中添加插件名称即可。例如：

plugins=(... pypi ...)

使用

基本命令

1. 列出支持的镜像

   pypi list

   该命令列出所有支持的 PyPI 镜像及其 URL。

2. 切换镜像

   pypi use <shortname> [--pip|--uv|--all]

   使用指定的镜像，<shortname> 是镜像的简写名。目标参数说明如下：

   • --pip：只修改 pip，默认值
   • --uv：只修改 uv 的用户级配置
   • --all：同时修改 pip 和 uv

   例如：

   pypi use aliyun

   pypi use aliyun --uv

   pypi use aliyun --all

3. 测试镜像连通性

   pypi ping <shortname|url>

   检查指定镜像的网络连通性，<shortname> 是镜像的简写名，也可以直接使用镜像的URL。例如：

   pypi ping tsinghua

   或

   pypi ping https://pypi.org/simple/

4. 查看当前配置

   pypi cur [--pip|--uv|--all]

   查看当前 pip 和/或 uv 的镜像配置。例如：

   pypi cur

   pypi cur --all

命令详情

• pypi list 列出支持的 PyPI 镜像及其 URL。
• pypi use <shortname> [--pip|--uv|--all] 切换到指定的 PyPI 镜像。
• pypi ping <shortname|url> 测试指定镜像或 URL 的网络连通性。
• pypi cur [--pip|--uv|--all] 查看当前 pip 和/或 uv 的镜像配置。

例子

列出所有支持的镜像：

pypi list

切换到阿里云镜像：

pypi use aliyun

只切换 uv 用户级配置到阿里云镜像：

pypi use aliyun --uv

同时切换 pip 和 uv 到清华镜像：

pypi use tsinghua --all

测试清华大学镜像的连通性：

pypi ping tsinghua

查看当前 pip 和 uv 配置：

pypi cur --all

支持的镜像

以下是一些支持的 PyPI 镜像及其简写名：

• pypi: https://pypi.org/simple/
• aliyun: https://mirrors.aliyun.com/pypi/simple/
• tencent: https://mirrors.cloud.tencent.com/pypi/simple/
• huawei: https://repo.huaweicloud.com/repository/pypi/simple/
• 163: https://mirrors.163.com/pypi/simple/
• tsinghua: https://pypi.tuna.tsinghua.edu.cn/simple/
• bfsu: https://mirrors.bfsu.edu.cn/pypi/web/simple/

更多镜像请使用 pypi list 查看。

注意事项

• ping 命令接受镜像简写名或直接 URL。
• use 命令需要提供有效的镜像简写名。
• pypi use <shortname> 默认只修改 pip；如需修改 uv，请显式使用 --uv 或 --all。
• uv 只管理用户级配置文件：${XDG_CONFIG_HOME:-~/.config}/uv/uv.toml。
• 如果 uv 配置文件不存在，插件会自动创建；如果已存在索引相关配置，插件会将索引相关项规范化为单镜像模式，并保留其他非索引配置。
• uv 的项目级配置、环境变量和命令行参数都可能覆盖用户级配置。

帮助

要查看每个命令的详细帮助信息，可以运行：

pypi <command> -h/--help

例如：

pypi use -h

License

This project is licensed under the MIT License - see the LICENSE file for details.