繁体

windows离线安装jpypr

老刘

Windows 离线安装 Jupyter：从零到可用的完整教程

目标关键词：Windows 离线安装 Jupyter

很多人在电脑上装 Jupyter 时，第一反应是直接联网执行 pip install jupyter，但实际工作里，经常会遇到这些情况：

  • 电脑不能联网
  • 公司内网限制外网访问
  • 需要给客户电脑批量部署
  • Python 环境已装好，但缺少 Jupyter 及依赖包
  • 安装时出现各种报错，比如 pip 失败、依赖缺失、权限不足

这时候，Windows 离线安装 Jupyter 就很有用。
下面我按“问题分析 → 解决方案 → 注意事项”的结构，手把手讲清楚，尽量让小白也能直接照着做。

一、问题分析：为什么 Jupyter 离线安装容易卡住

Jupyter 不是一个单独的小软件，它通常依赖一整套 Python 生态组件，比如：

  • jupyter
  • notebook
  • ipykernel
  • traitlets
  • pyzmq
  • tornado
  • jupyter-client
  • jupyter-core
  • nbformat

如果网络正常，pip 会自动去下载这些依赖；
但在离线环境里，pip 找不到安装包，就会报错。

所以，离线安装的核心思路不是“只拷贝一个 Jupyter”，而是：

  1. 先在一台能联网的电脑上把安装包全部下载好
  2. 把这些安装包拷贝到离线 Windows 电脑
  3. 在离线电脑本地安装

二、安装前准备：先确认这几个条件

在开始前，先确认你的 Windows 电脑满足以下条件：

1. 已安装 Python

建议使用：

  • Python 3.9
  • Python 3.10
  • Python 3.11

一般不建议新手用太老版本，比如 3.6、3.7，兼容性更容易出问题。

打开命令提示符，输入：

python --version

如果能看到版本号，说明 Python 已经装好。

如果提示不是内部命令，说明 Python 没装好，或者环境变量没配好。

2. 已安装 pIP

输入：

pip --version

如果能看到版本信息，说明 pip 正常。

如果不正常，可以先修复 Python 安装，确保安装时勾选了：

  • Add Python to PATH

3. 建议先建虚拟环境

虽然不是必须，但很推荐。
这样可以避免 Jupyter 和其他软件冲突。

进入你的项目目录后，执行：

python -m venv jupyter_env

激活虚拟环境：

jupyter_env\Scripts\activate

激活成功后，命令行前面通常会出现：

(jupyter_env)

三、Windows 离线安装 Jupyter 的标准方法

下面是最稳妥的一套流程。

第一步：在联网电脑上下载 Jupyter 及依赖包

找一台能上网的电脑，最好和离线电脑满足以下条件：

  • 同样是 Windows
  • Python 版本一致
  • 架构一致（一般都是 64 位）

这样下载到的包更容易直接安装。

1）先创建一个下载目录

比如：

mkdir jupyter_packages
cd jupyter_packages

2）下载 Jupyter 安装包和依赖

执行：

pip download jupyter -d jupyter_packages

这个命令会把 Jupyter 及其依赖包全部下载到 jupyter_packages 文件夹里。

如果你想更稳一点，也可以分别下载常见组件：

pip download notebook -d jupyter_packages
pip download jupyterlab -d jupyter_packages
pip download ipykernel -d jupyter_packages

如果是想装经典版 Jupyter Notebook，通常 jupyter 或 notebook 就够了。
如果你还想用新版界面，可以考虑 jupyterlab。

第二步：把下载好的安装包拷贝到离线电脑

把 jupyter_packages 整个文件夹复制到离线 Windows 电脑，比如放到：

D:\jupyter_packages

注意：

  • 不要只复制部分文件
  • 不要改动里面的 .whl 和 .tar.gz 文件
  • 文件路径尽量简单，避免中文路径和空格过多

第三步：在离线电脑上安装 Jupyter

打开命令提示符或 PowerShell，进入安装包目录：

cd /d D:\jupyter_packages

然后执行：

pip install --no-index --find-links=. jupyter

这条命令的意思是：

  • --no-index：不去网上找包
  • --find-links=.：只从当前文件夹找安装包

如果你下载的是 notebook，也可以直接装：

pip install --no-index --find-links=. notebook

如果你下载的是 jupyterlab：

pip install --no-index --find-links=. jupyterlab

四、如果提示缺少依赖，怎么处理

离线安装时，最常见的问题就是：

找不到某个依赖包

比如报错类似：

  • Could not find a version that satisfies the requirement ...
  • No matching distribution found ...
  • ERROR: Could not install packages due to an OSError

这说明你下载的包不完整，或者 Python 版本和包不匹配。

解决办法

方法 1：把缺失的依赖单独下载下来

比如报错缺 pyzmq，就在联网电脑上执行：

pip download pyzmq -d jupyter_packages

然后重新复制到离线电脑安装。

方法 2：一次性下载完整依赖

在联网电脑上，建议直接下载 Jupyter 的完整依赖链：

pip download jupyter notebook jupyterlab ipykernel -d jupyter_packages

这样成功率更高。

方法 3：检查 Python 版本是否匹配

有些包对 Python 版本有要求。
比如你用的是 Python 3.12，但某些旧包还没完全适配，就可能出问题。

如果报错很多，建议优先用：

  • Python 3.10
  • Python 3.11

兼容性通常更稳。

五、安装完成后怎么验证是否成功

安装完成后，输入：

jupyter notebook --version

或者：

jupyter --version

如果能输出版本号，说明安装成功。

然后启动 Jupyter：

jupyter notebook

如果是 JupyterLab：

jupyter lab

正常情况下，浏览器会自动打开本地页面，地址一般类似：

http://localhost:8888

如果浏览器没自动弹出，也可以手动复制命令行中的地址到浏览器打开。

六、经典版 Notebook 和 JupyterLab 的区别

很多新手会分不清这两个。

1. Jupyter Notebook

这是传统经典版界面，特点是：

  • 界面简单
  • 适合入门
  • 教程多
  • 兼容性稳定

适合：
初学者、教学、基础数据分析、日常写代码。

2. JupyterLab

这是新版界面，特点是：

  • 更现代
  • 支持多标签页
  • 文件管理更方便
  • 更适合复杂项目

适合：
进阶用户、数据科学、机器学习开发、多文件协作。

七、推荐的离线安装方案：最稳的两种方式

方案一：pip 离线安装

这是最通用的方法，适合大多数人。

优点

  • 灵活
  • 免费
  • 适合手动部署

缺点

  • 依赖包多时容易漏
  • 需要自己处理报错

方案二：Anaconda 离线安装

如果你主要是做数据分析、科学计算、Python 学习，Anaconda 会更省心。

安装思路

在联网电脑下载 Anaconda 安装包，然后离线安装。
安装后，Jupyter 通常可以直接使用，很多依赖也自带。

优点

  • 省事
  • 适合小白
  • 自带很多科学计算包

缺点

  • 安装包大
  • 占用空间更多
  • 不如纯 Python 环境轻量

如果你是第一次接触 Jupyter，且不想折腾依赖，Anaconda 是非常省心的选择。

八、常见报错与解决方法

1. pip 不是内部或外部命令

说明环境变量没配好。

解决方法

  • 重新安装 Python
  • 勾选 Add Python to PATH
  • 或者直接使用：
python -m pip install --no-index --find-links=. jupyter

这种写法不依赖单独的 pip 命令，兼容性更好。

2. 安装时报权限不足

如果提示权限问题，可以：

  • 右键命令提示符，选择“以管理员身份运行”
  • 或者使用虚拟环境安装

3. 启动 Jupyter 后网页打不开

可能是以下原因：

  • 浏览器被拦截
  • 端口被占用
  • 本地防火墙限制

解决方法

手动复制命令行里的地址打开。
如果端口冲突，可指定端口：

jupyter notebook --port=8889

4. 双击打不开 .ipynb

.ipynb 文件不是普通文档，必须通过 Jupyter 打开。
正确做法是启动 Jupyter 后，在网页界面中打开该文件。

九、实战建议：给小白的最省心流程

如果你是完全新手，我建议直接按这个顺序做：

方法 A：纯 pip 离线安装

  1. 联网电脑执行： 
    pip download jupyter -d jupyter_packages
  2. 把文件夹拷到离线电脑
  3. 离线电脑进入目录： 
    cd /d D:\jupyter_packages
  4. 安装： 
    pip install --no-index --find-links=. jupyter
  5. 启动： 
    jupyter notebook

方法 B：Anaconda 离线安装

  1. 下载 Anaconda 安装包
  2. 离线安装
  3. 打开 Anaconda Prompt
  4. 直接运行： 
    jupyter notebook

如果你不想研究依赖，选这个更轻松。

十、安装后建议做的优化

1. 固定工作目录

建议专门建一个文件夹放 Notebook 文件，比如：

D:\PythonProject\Notebook

这样找文件更方便。

2. 关闭不必要的浏览器窗口

Jupyter 启动后默认打开浏览器，如果你电脑配置一般，建议只保留一个标签页，减少卡顿。

3. 养成虚拟环境习惯

以后每个项目单独建环境，避免包冲突。

常用命令：

python -m venv env
env\Scripts\activate
python -m pip install --upgrade pip

4. 备份安装包

既然你已经离线下载过一次，建议把 jupyter_packages 备份到 U 盘或移动硬盘。
下次重装系统、换电脑时，能直接复用。

十一、总结

Windows 离线安装 Jupyter 的核心就是一句话：
先在联网电脑下载完整依赖包，再复制到离线电脑本地安装。

最常用的命令如下：

联网电脑下载：

pip download jupyter -d jupyter_packages

离线电脑安装：

pip install --no-index --find-links=. jupyter

启动 Jupyter：

jupyter notebook

如果你想更省事，直接上 Anaconda 离线安装 也很合适，尤其适合新手和数据分析场景。

只要按上面的步骤操作，基本都能顺利完成 Windows 离线安装 Jupyter。

文章版权声明：文章内容均来源于各大短视频平台搜集以及修改和删减新增，如有侵权或者违规，请联系站长进行删除，如需转载或复制请以超链接形式并注明出处。

相关阅读

发表评论

快捷回复： 表情：
AddoilApplauseBadlaughBombCoffeeFabulousFacepalmFecesFrownHeyhaInsidiousKeepFightingNoProbPigHeadShockedSinistersmileSlapSocialSweatTolaughWatermelonWittyWowYeahYellowdog
验证码
评论列表 （暂无评论，3人围观）

还没有评论，来说两句吧...

目录[+]