蓝盐泳池1983Jupyter Notebook的安装，网上教程一抓一大把，但我敢说大多数人都是照着别人的步骤敲了一遍，然后在自己电脑上报错，回头再找原因，发现根本不知道该查哪。我自己也经历过这个阶段，装完一遍之后才发现，真正的问题根本不在于“安装命令”本身，而是安装前的那堆准备工作——你的电脑里到底有什么环境，哪些命令能用，哪些版本匹配，这些才是决定成败的关键。
这篇分享我不会只教你敲两行命令，而是把整个“从零开始装到能正常用、能舒服用”的链路完整走一遍。文章覆盖安装前的环境自查、不同平台下的安装方式、最让人头疼的“subprocess-exited-with-error”这类报错的完整排查思路、首次启动后的基础操作，以及很多人都会问的“侧边栏如何显示标题总览”和“目录插件怎么装”这两个实用需求。无论你是刚接触Python的纯新手，还是以前装了一半卡在某个问题上的人，按照这篇的顺序走，基本上都能解决大部分问题。
1. 别着急输命令：我先说点安装前必须想清楚的事
很多人拿到教程第一步就是打开终端复制安装命令，这恰恰是后面出问题的根源。Jupyter Notebook本身不是一个独立的软件，它运行在Python环境之上，你的电脑里Python装得怎么样、装了什么版本、用的是虚拟环境还是全局环境，这些都会直接影响安装结果。
1.1 用不用Anaconda，不要凭感觉选
关于Anaconda和Jupyter的关系，我用一句话讲清楚：Anaconda是一个Python的集成发行版，它把Python解释器、常用科学计算库、包管理器conda，以及Jupyter Notebook这一系列工具都打包好了一起给你。也就是说，装了Anaconda，其实Jupyter Notebook是附带的，你基本不需要再单独折腾安装。
但Anaconda的缺点是太庞大，新版装完少说好几个G，里面很多包你可能永远用不到。所以现在更多人倾向于用Miniconda或纯Python环境去安装。Miniconda就是Anaconda的精简版，只包含conda和Python，后面需要什么再装什么，干净利落。
而如果你已经单独装了Python，那直接用pip安装Jupyter Notebook是最快的方式。这里没有唯一正确答案，选择标准很简单：
| 方案 | 适合场景 | 缺点 |
|---|---|---|
| 完整Anaconda | 完全新手，不想理解环境管理，想开箱即用 | 体积大，冗余多 |
| Miniconda | 能接受命令行操作，想轻量但保留conda便利性 | 需要自己装Jupyter |
| pip + Python | 已经有了Python环境，或偏好最小化安装 | 对新手来说环境隔离要额外注意 |
| Docker镜像 | 不想污染本地环境，想要可复现环境 | 桌面端使用不直观，有学习成本 |
如果你问我的建议，纯新手直接从Miniconda开始比较合适。它没有Anaconda那么臃肿，但conda后面帮你创建隔离环境的时候是真的省心。
1.2 理解“环境隔离”这回事，而不是装到一个篮子里
做Python开发超过半年的人，基本都遇到过“这个包升级之后别的项目跑不了”的糟心事。Jupyter Notebook也是Python生态里的一分子，它依赖一堆底层库，比如ipykernel、jupyter-core、nbformat，一旦这些依赖和系统里已有的包的版本产生冲突，安装就会报错，或者装完了启动时各种莫名其妙的崩溃。
所以我的习惯是，打开终端之后先检查一下你现在处于哪个Python环境里。Windows上在cmd或PowerShell执行：
bash复制where python
macOS或Linux执行：
bash复制which python
如果输出路径带着anaconda或者miniconda的字样，说明你已经在conda环境下。如果输出是/usr/bin/python或C:\Pythonxx，说明你用的是系统级Python。
知道自己在哪个环境，是为了防止你辛辛苦苦装了半天，结果装到了一个你不常用、甚至权限受限的环境里，后面打开Jupyter又找不到内核，但你自己还没意识到。
还有一种情况特别值得提醒：Windows用户喜欢直接从微软商店安装Python。商店版Python会自带一个禁用的别名机制，有时候你在终端输入python，弹出的不是解释器，而是商店页面。装Jupyter前最好先关掉“应用执行别名”里的这两个开关，否则后续会很折腾。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 从零到真正能用：安装过程的分步实测
确认好环境信息后，开始装。为了方便对照，我分两种情况说明：用conda和用pip。
2.1 conda或Miniconda环境下的安装步骤
如果你装了Miniconda，打开Anaconda Prompt（Windows会自动有这个入口），或者终端里确保conda命令可用后执行：
bash复制conda create -n jupyter-env python=3.9 -y
conda activate jupyte