Jupyter Notebook 怎么修改默认的镜像源

轻丽酱_8466

轻丽酱_8466

2026-08-13

973人浏览

原创

应优先使用中科大镜像源(https://mirrors.ustc.edu.cn/anaconda/)或北外镜像源,执行conda config --remove-key channels清除旧配置后,再逐条添加中科大各channel并启用show_channel_urls;pip需单独配置pip.ini或pip.conf,注意trusted-host须与index-url域名一致,且改源后须运行conda clean -i清理索引缓存。

jupyter notebook 怎么修改默认的镜像源

conda 镜像源怎么换(清华/中科大)

Jupyter Notebook 本身不管理包源,它依赖 conda 或 pip 安装包;改镜像源本质是改 conda/pip 的配置。清华镜像站自 2023 年起已逐步停用部分服务,目前推荐中科大镜像源(https://mirrors.ustc.edu.cn/anaconda/)或北外镜像(https://mirrors.bfsu.edu.cn/anaconda/)。

执行以下命令一次性替换 conda 源:

conda config --remove-key channels
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/main/
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/pkgs/free/
conda config --add channels https://mirrors.ustc.edu.cn/anaconda/cloud/conda-forge/
conda config --set show_channel_urls yes

验证是否生效:

conda config --show channels

常见错误现象:CondaHTTPError: HTTP 404 NOT FOUND 多因残留清华旧地址未清理干净,务必先执行 conda config --remove-key channels 再添加新源。

pip 镜像源怎么配(不影响 conda)

conda 管环境,pip 管包——有些包(如 ipykernel)必须用 pip 装,这时需单独配 pip 源。Windows 下需手动创建 %USERPROFILE%\pip\pip.ini 文件(注意路径中不能有中文或空格),Linux/macOS 是 ~/.pip/pip.conf。

文件内容写成:

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

或者换中科大源:

Jupyter Notebook 7.5.4
Jupyter Notebook 7.5.4

Jupyter Notebook 7.5.4 官方 PyPI wheel 包下载,适合用于本地交互式代码运行、数据分析、教学演示和配置文件实践。

下载
[global]
index-url = https://pypi.mirrors.ustc.edu.cn/simple/
trusted-host = pypi.mirrors.ustc.edu.cn

注意:trusted-host 必须和 index-url 域名一致,否则 pip 会拒绝连接;若用 HTTPS 但证书校验失败,可加 --trusted-host 参数临时绕过(不推荐长期使用)。

为什么改了源还是慢 / 报错

容易踩的坑不止配置本身,还有几个隐性干扰点:

  • conda install 时如果指定了 -c conda-forge,会强制走 conda-forge 官方源,忽略你配的镜像;删掉 -c 参数再试
  • Jupyter 启动后安装包(比如在 cell 里运行 !pip install xxx),走的是当前 kernel 对应 Python 解释器的 pip,不是你系统默认 pip —— 要确认 kernel 是否在你配好源的环境中
  • 某些公司/校园网络会拦截或重定向 HTTPS 请求,导致镜像域名解析失败;可尝试用 curl -I https://mirrors.ustc.edu.cn 测试连通性
  • .condarc 文件若存在语法错误(比如多了一个冒号、引号没闭合),conda 会静默失效,直接报超时而非明确提示

jupyter notebook 启动时如何指定 kernel 环境源

你改的是全局 conda/pip 源,但 Jupyter 可能用多个 kernel(比如不同虚拟环境)。每个 kernel 的 pip 源取决于它所在环境的 pip.ini 或 pip.conf,不是 notebook 主进程决定的。

要确保某个 kernel 使用指定源,得进入该环境再配 pip:

conda activate myenv
pip config set global.index-url https://pypi.mirrors.ustc.edu.cn/simple/

或者更稳妥:在 kernel 对应的 Python 中运行:

import pip
pip.main(['config', 'set', 'global.index-url', 'https://pypi.mirrors.ustc.edu.cn/simple/'])

注意:pip config 命令在 pip ≥ 10.0 才支持;老版本只能手动写配置文件。

最常被忽略的一点:改完源后,conda clean -i 清掉索引缓存,否则旧缓存可能继续拉取失败的地址。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
pip安装使用方法
pip安装使用方法

安装步骤:1、确保Python已经正确安装在您的计算机上;2、下载“get-pip.py”脚本;3、按下Win + R键,然后输入cmd并按下Enter键来打开命令行窗口;4、在命令行窗口中,使用cd命令切换到“get-pip.py”所在的目录;5、执行安装命令;6、验证安装结果即可。大家可以访问本专题下的文章,了解pip安装使用方法的更多内容。

2023.10.09

2730

5

更新pip版本
更新pip版本

更新pip版本方法有使用pip自身更新、使用操作系统自带的包管理工具、使用python包管理工具、手动安装最新版本。想了解更多相关的内容,请阅读专题下面的文章。

2024.12.20

6283

6

pip设置清华源
pip设置清华源

设置方法:1、打开终端或命令提示符窗口;2、运行“touch ~/.pip/pip.conf”命令创建一个名为pip的配置文件;3、打开pip.conf文件,然后添加“[global];index-url = https://pypi.tuna.tsinghua.edu.cn/simple”内容,这将把pip的镜像源设置为清华大学的镜像源;4、保存并关闭文件即可。

2024.12.23

7862

11

python升级pip
python升级pip

本专题整合了python升级pip相关教程,阅读下面的文章了解更多详细内容。

2025.07.23

3887

16

FrankenPHP集成Laravel详细教程
FrankenPHP集成Laravel详细教程

本专题提供FrankenPHP集成Laravel的详细配置指南,全面解析运行原理、开发环境搭建、Caddyfile配置、Octane工作模式、数据库连接、队列任务、定时任务和生产环境优化,解决部署过程中常见的报错与兼容性问题。

2026.10.08

0

20

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

120

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

100

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

80

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

80

26

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程