好的，阿杰，我帮你整理一份 Python 修改 pip 源为国内源的完整方法，包括临时修改、永久修改以及推荐的国内源。

1️⃣ 为什么要修改 pip 源

  • 默认 pip 源是国外的 https://pypi.org/simple
  • 在国内网络环境下，下载速度慢或连接超时
  • 使用国内源可以显著加速安装 Python 包

2️⃣ 临时修改 pip 源

  • 使用 -i 参数指定源，只对当前命令有效：
pip install 包名 -i https://pypi.tuna.tsinghua.edu.cn/simple

示例：

pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple

常用国内源：

  • 清华大学：https://pypi.tuna.tsinghua.edu.cn/simple
  • 阿里云：https://mirrors.aliyun.com/pypi/simple/
  • 中国科技大学：https://pypi.mirrors.ustc.edu.cn/simple/
  • 华为云：https://repo.huaweicloud.com/repository/pypi/simple

3️⃣ 永久修改 pip 源

3.1 方法一：修改配置文件（推荐）

  • Windows：
    • 配置文件路径：%APPDATA%\pip\pip.ini
    • 如果没有 pip 文件夹或 pip.ini，可以新建
  • Linux / macOS：
    • 配置文件路径：~/.pip/pip.conf
    • 如果没有 .pip 文件夹或 pip.conf，可以新建

3.2 配置内容示例

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

解释：

  • index-url：指定默认 pip 源
  • trusted-host：信任的主机，避免 SSL 验证问题

3.3 验证是否生效

pip config list

或者安装包测试：

pip install numpy

如果显示使用的是你指定的国内源，则修改成功。

4️⃣ 方法二：使用命令行设置（永久生效）

# 设置默认源（全局）
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple
pip config set global.trusted-host pypi.tuna.tsinghua.edu.cn
  • Windows 也适用，pip 会自动生成配置文件
  • 验证方法同上

5️⃣ 其他小技巧

  1. 安装多个包加速：
pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -U requests numpy pandas
  1. 升级 pip（推荐使用国内源）：
python -m pip install --upgrade pip -i https://pypi.tuna.tsinghua.edu.cn/simple
  1. 切换其他源：只需修改 pip.ini 或执行 pip config set 即可

总结：

方法优缺点示例
临时修改只对当前命令有效pip install requests -i https://pypi.tuna.tsinghua.edu.cn/simple
永久修改配置文件永久生效pip.ini 或 pip.conf 配置 index-url
命令行设置永久生效pip config set global.index-url ...

明白了，阿杰，我帮你写一个 Python pip 国内源配置一键脚本，支持 Windows 和 Linux/macOS，执行一次即可永久生效。

一键配置脚本（Python）

import os
import sys
import platform
import subprocess

# 国内镜像源，可自行替换
mirror_url = "https://pypi.tuna.tsinghua.edu.cn/simple"

def configure_pip_windows():
    pip_config_dir = os.path.join(os.environ.get("APPDATA"), "pip")
    os.makedirs(pip_config_dir, exist_ok=True)
    pip_config_file = os.path.join(pip_config_dir, "pip.ini")
    
    config_content = f"""[global]
index-url = {mirror_url}
trusted-host = {mirror_url.replace('https://', '')}
"""
    with open(pip_config_file, "w", encoding="utf-8") as f:
        f.write(config_content)
    print(f"Windows pip 配置完成: {pip_config_file}")

def configure_pip_unix():
    pip_config_dir = os.path.join(os.path.expanduser("~"), ".pip")
    os.makedirs(pip_config_dir, exist_ok=True)
    pip_config_file = os.path.join(pip_config_dir, "pip.conf")
    
    config_content = f"""[global]
index-url = {mirror_url}
trusted-host = {mirror_url.replace('https://', '')}
"""
    with open(pip_config_file, "w", encoding="utf-8") as f:
        f.write(config_content)
    print(f"Unix/Linux/macOS pip 配置完成: {pip_config_file}")

def main():
    system = platform.system()
    if system == "Windows":
        configure_pip_windows()
    else:
        configure_pip_unix()
    
    # 验证配置
    try:
        subprocess.run([sys.executable, "-m", "pip", "config", "list"], check=True)
        print("验证完成，可以使用国内源安装包了！")
    except Exception as e:
        print("验证失败，请手动检查 pip 配置:", e)

if __name__ == "__main__":
    main()

使用方法

  1. 保存为 pip_mirror.py
  2. 执行脚本：
python pip_mirror.py
  1. 脚本会自动：
    • 检测系统类型（Windows / Linux / macOS）
    • 创建 pip 配置文件
    • 写入国内源（清华镜像）
    • 输出配置路径并验证
  2. 验证安装：
pip install numpy