树莓派换源pip
时间: 2025-05-02 13:48:19 浏览: 35
### 更换树莓派上的 Pip 源为国内镜像
为了提高在树莓派上使用 `pip` 安装 Python 包的速度,可以通过更改默认的 PyPI 源到国内的镜像站点来实现。以下是具体方法:
#### 创建 `.pip` 目录并设置配置文件
如果尚未存在 `.pip` 文件夹,则需要手动创建它。执行以下命令以完成此操作:
```bash
mkdir ~/.pip
```
接着,在该目录下新建名为 `pip.conf` 的配置文件,并编辑其内容以便指定所需的国内镜像地址[^3]。
对于 Linux 或 macOS 用户来说(包括基于 Debian 的 Raspbian),应将上述提到的新建路径设为 `$HOME/.pip/pip.conf`;而对于 Windows 平台而言则是 `%HOMEPATH%\pip\pip.ini`。
下面是一个典型的 `pip.conf` 文件示例,其中包含了清华大学开源软件镜像服务作为索引 URL:
```ini
[global]
index-url = https://pypi.tuna.tsinghua.edu.cn/simple
trusted-host = pypi.tuna.tsinghua.edu.cn
```
这段代码的作用是指定新的简单模式下的包托管位置以及信任对应的主机名。
另外还有其他几个常用的中国境内 PIP 镜像可以选择替换上面链接中的部分或者全部字段,比如阿里云、豆瓣等提供的选项也可以考虑加入备用方案列表里去尝试切换不同的服务器获取更佳性能表现[^1]。
#### 使用临时参数快速测试新源效果
如果不希望永久改变全局设定而只是想即时验证某个特定仓库的表现情况的话,可以直接附加 `-i/--index-url` 参数给具体的安装指令后面加上目标网站URL即可做到这一点而不影响原有环境状态。例如要利用 Tsing Hua 大学所提供的资源下载 NumPy 库就可以这样写:
```bash
pip install numpy -i https://pypi.tuna.tsinghua.edu.cn/simple --trusted-host pypi.tuna.tsinghua.edu.cn
```
以上方式同样适用于任何支持标准 PYPI 协议的服务提供商所开放出来的公开接口地址[^2]。
### 注意事项
当完成了这些调整之后记得重新启动终端会话使改动生效再继续下一步骤的操作流程。同时也要留意定期检查官方文档更新是否有最新的最佳实践建议发布出来供参考采用。
阅读全文
相关推荐

















