Python仓库用户手册

简介

龙芯 Python 仓库是专门针对 LoongArch 平台优化的 PyPI 镜像源，为官方 PyPI 仓库的补充，主要存放支持 LA 架构的 Python 源码及二进制包。

在 LoongArch 环境下使用 Python 时，建议优先配置此镜像源，以获得更好的兼容性支持。

pip仓库介绍

根据系统 C 标准库（libc）类型及版本的不同，龙芯提供两个不同的镜像地址。请根据下表选择：

注意：glibc==2.28 PyPI 源中提供的 manylinux wheel 包可以在 glibc>=2.38 的环境中成功安装，但无法正常使用！

pip仓库配置

方法一：自动配置（推荐）

下载并运行自动化配置脚本 set-pip.sh，脚本会自动识别 glibc 或 musl 的版本并选择最佳镜像源。

wget https://cloud.loongnix.cn/releases/loongarch64/python/set-pip.sh
chmod +x set-pip.sh
# 为当前用户添加配置
./set-pip.sh 

# 为所有用户添加配置（需要 sudo 权限）
./set-pip.sh -g

# 更新 pip 工具
pip3 install -U pip

方法二：手动配置

如果你需要手动维护配置文件，请按以下步骤操作：

1. 确定 libc 类型与版本

执行以下命令查看当前环境：

ldd --version

• 如果输出包含 GNU libc，则为 glibc 环境。
• 如果输出包含 musl libc，则为 musl 环境。

2. 编写配置文件

以 musl >= 1.2 或 glibc >= 2.38 环境举例（使用 lpypi 镜像）：

为当前用户配置：

mkdir -p ~/.pip
tee ~/.pip/pip.conf > /dev/null <<EOF
[global]
timeout = 60
index-url = https://lpypi.loongnix.cn/loongson/pypi/+simple

[install]
trusted-host = lpypi.loongnix.cn
EOF

为所有用户配置（全局）：

sudo tee /etc/pip.conf > /dev/null <<EOF
[global]
timeout = 60
index-url = https://lpypi.loongnix.cn/loongson/pypi/+simple

[install]
trusted-host = lpypi.loongnix.cn
EOF

3. 更新 pip 工具

配置完成后，更新 pip 以确保它能识别到 manylinux 标签：

pip3 install -U pip

反馈

如您在使用过程中遇到问题，或者有软件包需添加至仓库，请联系我们。
反馈邮箱:service@loongnix.cn