pip config list输出为空？如何配置pip镜像源？不同方式配置有什么区别？

🤟致敬读者

• 🟩感谢阅读🟦笑口常开🟪生日快乐⬛早点睡觉

📘博主相关

• 🟧博主信息🟨博客首页🟫专栏推荐🟥活动信息

---

---

📃文章前言

• 🔷文章均为学习工作中整理的笔记。
• 🔶如有错误请指正，共同学习进步。

---

---

最近电脑系统重装了，然后装了python的环境，想配置一下包管理器的镜像源地址
使用 pip config list 命令后输出空内容，一开始感觉有点不对劲，因为之前都是有默认的镜像源地址出来的，但是现在啥也没有，于是就去查了一下，发现啥也没有也正常。

一、为什么输出为空

1. 原因

pip 正在使用所有默认配置，没有任何自定义设置。

可以把这理解成 pip 的“出厂设置”。输出为空不代表配置不存在或出错了，而是代表没有修改过任何默认的配置项。

2. 详解

pip 的配置系统是分层级的，它会从多个地方读取配置。pip config list 命令只显示与默认值不同的、已生效的自定义配置。

由于您没有修改过任何配置，所以没有内容可显示。

真实操作截图如下

---

二、如何配置

如果您在中国大陆，从默认的国外 PyPI 源下载包可能会非常慢甚至失败。这时您就需要添加配置，让 pip config list 不再输出空内容了。

一个常见的操作是为 pip 换源（例如切换到清华大学镜像源）：

1. 设置清华源：

   pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
   pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn
   

   实际操作如下
   

2. 再次检查配置：

   pip config list
   

   现在您应该能看到输出了：

   global.index-url='https://pypi.tuna.tsinghua.edu.cn/simple'
   install.trusted-host='pypi.tuna.tsinghua.edu.cn'
   

   实际操作如下
   

总结：pip config list 输出空内容是正常且良好的状态，表示您的 pip 环境是干净且未修改的。只有当您有特殊需求（如换源、设置代理）时，才需要去修改它。

---

三、不同配置方式的优先级如何？

这是pip 配置优先级的核心概念。

简单直接的答案是：使用 pip config set 命令进行的配置，其优先级取决于您执行命令时所在的环境（尤其是是否在虚拟环境中），而手动创建的 pip.ini 文件的优先级由其所在的位置决定。

这两种方式不是“两种并列的方法”，而是 “命令工具” 和 “手动编辑” 的关系。pip config set 命令的本质就是帮您自动在正确的目录创建或修改 pip.ini 文件。

1. 配置优先级规则

pip 配置的优先级从高到低如下：

1. 命令行参数 (最高优先级)

   • 例如：pip install package -i https://pypi.douban.com/simple/
   • 这次命令临时覆盖所有配置。

2. 环境变量

   • 例如：PIP_INDEX_URL=https://pypi.douban.com/simple/

3. 虚拟环境级配置 (venv\pip.ini)

   • 如果当前在虚拟环境中，此处的配置优先级最高。

4. 用户级配置 (%APPDATA%\pip\pip.ini)

   • 这是最常用、最推荐的全局自定义配置位置。

5. 全局配置 (C:\ProgramData\pip\pip.ini) (最低优先级)

   • 影响机器上的所有用户。

高优先级的配置会覆盖低优先级的配置。

2. 两种方式的具体区别和优先性

让我们来分析您提到的两种方式：

1. 使用 pip config set 命令

当您执行 pip config set 时，pip 会自动判断应该将配置写入哪个位置的 pip.ini 文件。

• 如果您在虚拟环境 (venv) 中执行命令：

  • pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
  • 这条命令会在当前虚拟环境的目录下（例如 my_venv\pip.ini）创建或修改配置。
  • 优先级：高。此配置仅对该虚拟环境生效，不会影响系统其他环境。

• 如果您在系统的全局 Python 环境中执行命令（即没有激活任何 venv）：

  • 同样的命令会在用户目录下（%APPDATA%\pip\pip.ini）创建或修改配置。
  • 优先级：中。此配置对该用户的所有非虚拟环境生效。

2. 手动在 %APPDATA%\pip\ 目录下创建 pip.ini 文件

这种方式是直接手动创建或编辑配置文件。

• 它的位置是确定的：C:\Users\[你的用户名]\AppData\Roaming\pip\pip.ini
• 其优先级属于用户级配置。

---

3. 哪个会被优先使用？—— 场景分析

假设您同时存在多个配置，pip 会按照优先级顺序读取并使用第一个找到的有效配置。

场景	虚拟环境中的 pip.ini	用户目录的 pip.ini (%APPDATA%)	最终生效的配置（获胜方）
1. 仅在用户目录有配置	不存在	index-url = 清华源	用户目录配置 (清华源)
2. 仅在虚拟环境有配置	index-url = 阿里源	不存在	虚拟环境配置 (阿里源)
3. 两者都有配置	index-url = 阿里源	index-url = 清华源	虚拟环境配置 (阿里源)
4. 两者都无配置	不存在	不存在	默认官方源 (pypi.org)

结论：

• 虚拟环境内的配置优先级高于用户目录的配置。
• 因此，无法简单地说“命令”和“手动”哪个优先，而是要看配置被写入到了哪个位置的文件。而 pip config set 命令的写入位置取决于您执行命令时所在的环境。

4. 实践建议

1. 推荐使用 pip config set 命令：因为它自动处理了文件路径、格式和编码问题，更简单不易出错。例如，为用户级全局设置清华源：

   # 确保没有激活任何虚拟环境！
   pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
   pip config set install.trusted-host pypi.tuna.tsinghua.edu.cn
   

2. 为特定项目使用虚拟环境并单独配置：如果一个项目需要特殊的私有源，可以在该项目对应的虚拟环境中设置，这会覆盖全局的用户级配置，且不影响其他项目。

   # 激活虚拟环境后
   venv\Scripts\activate
   # 然后设置镜像源，此配置只会写入到当前 venv 中
   (venv) pip config set global.index-url https://your-private-mirror.com/simple
   

3. 检查最终生效的配置：无论用什么方式配置，都可以用以下命令检查当前环境下真正生效的配置：

   pip config list
   # 或者更详细地查看
   pip config list -v
   

总结：优先级由配置文件所在的位置决定，而不是由创建方式（命令或手动）决定。 pip config set 只是一个更方便的自动化工具。虚拟环境的配置总会优先于用户目录的配置。

---

---

📜文末寄语

• 🟠关注我，获取更多内容。
• 🟡技术动态、实战教程、问题解决方案等内容持续更新中。
• 🟢《全栈知识库》技术交流和分享社区，集结全栈各领域开发者，期待你的加入。
• 🔵​加入开发者的《专属社群》，分享交流，技术之路不再孤独，一起变强。
• 🟣点击下方名片获取更多内容🍭🍭🍭👇

---