Jupyter Notebook 安装教程：Python 3.10 版本

• 等待安装完成（可能需要 1-2 分钟，看网络），出现 Successfully installed jupyter 即成功。

3. 验证 Jupyter 安装

jupyter --version

能显示 jupyter core 版本号，说明安装成功。

三、启动 Jupyter Notebook

1. 启动命令

jupyter notebook

• 执行后，终端会输出日志，同时自动弹出浏览器页面（地址通常是 http://localhost:8888/）。
• 如果没自动弹浏览器，复制终端里的 http://localhost:8888/?token=xxx 链接，手动粘贴到浏览器。

2. 验证启动成功

浏览器页面会显示 Jupyter 的主界面（左侧是当前目录的文件，右上角有 New 按钮），说明启动成功。

3. 新建第一个 Python 文件

1. 点击右上角 New → 选择 Python 3；
2. 会打开一个空白的笔记本（.ipynb 文件）；
3. 在代码框里输入 print("Hello Jupyter!")；
4. 点击代码框左侧的 ▶️ Run 按钮；
5. 下方会输出 Hello Jupyter!，说明能正常运行代码。

四、常见问题与解决方案

问题 1：Windows 提示'jupyter 不是内部命令'

• 原因：Python 的 Scripts 目录没加入环境变量；
• 解决：
  1. 找到 Python 安装目录（比如 C:\Users\你的用户名\AppData\Local\Programs\Python\Python310\Scripts）；
  2. 把这个路径添加到系统环境变量 Path 里；
  3. 重启命令提示符，重新执行 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