一份分系统、零门槛、带验证、避坑版的Jupyter详细安装教程，每一步都标清楚，跟着做就能装成功。
核心前提
Jupyter依赖Python环境（3.8及以上版本最佳），所以先装Python，再装Jupyter。
一、先确认/安装Python（所有系统第一步）
1. 检查是否已装Python
打开终端/命令提示符，输入：
python –version # Windows/Mac/Linux通用（部分Mac需用python3）
# 或
python3 –version
-
如果输出 Python 3.8.x / 3.9.x / 3.10.x → 跳过“安装Python”，直接装Jupyter
-
如果提示“不是内部命令” → 按下面步骤装Python
2. 安装Python（未安装时）
Windows系统
下载地址：https://www.python.org/downloads/windows/（选3.10.x版本，稳定）
安装时必须勾选：Add Python 3.10 to PATH（最关键，否则终端找不到Python）
点击Install Now，等待安装完成
验证：重新打开命令提示符，输入python –version，能显示版本即成功
macOS系统
推荐用Homebrew（Mac开发者必备），终端输入：
# 先装Homebrew（如果没装）
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 装Python
brew install python3
验证：终端输入python3 –version
Linux系统（Ubuntu/CentOS）
# Ubuntu
sudo apt update && sudo apt install python3 python3-pip -y
# CentOS
sudo yum install python3 python3-pip -y
# 验证
python3 –version
二、安装Jupyter（所有系统通用步骤）
1. 升级pip（避免安装失败）
终端/命令提示符输入：
# Windows
python -m pip install –upgrade pip
# Mac/Linux
python3 -m pip install –upgrade pip
2. 安装Jupyter
# Windows
pip install jupyter
# Mac/Linux
pip3 install jupyter
- 等待安装完成（可能需要1-2分钟，看网络），出现Successfully installed jupyter即成功。
3. 验证Jupyter安装
输入：
# Windows
jupyter –version
# Mac/Linux
jupyter3 –version
能显示jupyter core版本号，说明安装成功。
三、启动Jupyter Notebook
1. 启动命令
# Windows
jupyter notebook
# Mac/Linux
jupyter3 notebook
-
执行后，终端会输出日志，同时自动弹出浏览器页面（地址通常是http://localhost:8888/）。
-
如果没自动弹浏览器，复制终端里的http://localhost:8888/?token=xxx链接，手动粘贴到浏览器。
2. 验证启动成功
浏览器页面会显示Jupyter的主界面（左侧是当前目录的文件，右上角有New按钮），说明启动成功。
3. 新建第一个Python文件
点击右上角New → 选择Python 3；
会打开一个空白的笔记本（.ipynb文件）；
在代码框里输入print("Hello Jupyter!")；
点击代码框左侧的▶️ Run按钮；
下方会输出Hello Jupyter!，说明能正常运行代码。
四、常见问题&避坑方案
问题1：Windows提示“jupyter不是内部命令”
-
原因：Python的Scripts目录没加入环境变量；
-
解决：
-
找到Python安装目录（比如C:\\Users\\你的用户名\\AppData\\Local\\Programs\\Python\\Python310\\Scripts）；
-
把这个路径添加到系统环境变量Path里；
-
重启命令提示符，重新执行jupyter notebook。
问题2：Mac/Linux安装后提示“找不到jupyter”
- 解决：用~/.local/bin/jupyter notebook启动，或把~/.local/bin加入环境变量。
问题3：启动时端口8888被占用
-
解决：指定其他端口启动：
jupyter notebook –port 8889
问题4：安装速度慢/超时
-
解决：用国内镜像源安装：
# Windows
pip install jupyter -i https://pypi.tuna.tsinghua.edu.cn/simple# Mac/Linux
pip3 install jupyter -i https://pypi.tuna.tsinghua.edu.cn/simple
