Jupyter Notebook 安装与配置完整指南

启动 Anaconda Navigator

安装完成后，可以在开始菜单中找到 Anaconda Navigator 应用程序的快捷方式，点击打开即可。或者在命令行窗口中输入 anaconda-navigator 命令启动。打开后可以看到这样的界面，点击 Jupyter Notebook 下的 launch 按钮即可。

情况二：利用 pip 命令安装 Jupyter Notebook

首先需要确保已安装 Python

Windows 系统

1. 打开命令提示符：按下 Win + R 键，输入 "cmd"，按下回车键打开命令提示符窗口。
2. 安装 Jupyter Notebook：在命令提示符中输入以下命令，使用 pip 安装 Jupyter Notebook。

   pip install jupyter notebook
   

3. 启动 Jupyter Notebook：在命令提示符中输入以下命令，启动 Jupyter Notebook。

   jupyter notebook
   

4. 接下来 Jupyter Notebook 会在默认的浏览器中打开，如果没有自动打开，可以在浏览器中输入 http://localhost:8888/tree 来访问。

Linux / macOS 系统

1. 打开终端。
2. 升级 pip 版本（可选但推荐）：

   python3 -m pip install --upgrade pip
   

3. 安装 Jupyter Notebook：

   pip3 install jupyter
   

   或者指定清华源加速：

   pip3 install jupyter -i https://pypi.tuna.tsinghua.edu.cn/simple
   

4. 启动服务：

   jupyter notebook
   

常见问题排查

在使用 pip 安装 Jupyter Notebook 的过程中，可能会遇到以下问题：

1. 依赖库安装失败：Jupyter Notebook 需要依赖其他 Python 库，如果其中任何一个依赖库安装失败，都会导致 Jupyter Notebook 安装失败。此时可以尝试使用 --user 参数重新安装依赖库，或者升级 pip 版本后再次安装。 具体升级 pip 的方法如下：

   python -m pip install --upgrade pip
   

   若您安装的是 python3 版本，则输入：

   python3 -m pip install --upgrade pip
   

   升级后可通过 pip --version 来验证是否更新到最新版本。

2. 安装速度慢：pip 安装 Jupyter Notebook 的过程可能需要下载和安装大量文件，如果网络速度较慢，安装过程可能会非常缓慢。此时可以考虑更换下载源或者使用代理，或者直接下载安装包进行安装。

3. 安装版本问题：pip 可能会安装不兼容当前系统或其他库版本的 Jupyter Notebook，导致运行时出现错误或者无法正常运行。此时可以查看 Jupyter Notebook 官方文档，确定当前系统和依赖库版本兼容的 Jupyter Notebook 版本，并指定版本号进行安装。

   pip install jupyter==1.0.0
   

4. 权限问题：在某些情况下，安装过程需要管理员权限才能进行。此时可以使用管理员权限打开命令行窗口进行安装。

5. 端口被占用：如果启动时提示端口 8888 被占用，可以修改配置文件指定其他端口。

高级配置

生成配置文件

首次启动 Jupyter Notebook 时，会自动生成配置文件。可以通过以下命令生成：

jupyter notebook --generate-config

配置文件通常位于 ~/.jupyter/jupyter_notebook_config.py。

设置访问密码

为了安全起见，建议设置访问密码。

1. 在 Python 环境中导入模块：

   from notebook.auth import passwd
   

2. 输入两次密码，会生成加密后的哈希字符串。
3. 编辑配置文件 jupyter_notebook_config.py，找到 c.NotebookApp.password 行，填入生成的哈希值。

自定义启动目录

可以通过命令行参数指定启动目录：

jupyter notebook --notebook-dir=/path/to/your/project

基本使用技巧

1. 创建 Notebook：在首页点击 "New" 按钮，选择对应的 Python 内核。
2. 单元格类型：支持代码单元格（Code）和 Markdown 单元格（Markdown），可按 M 切换为 Markdown，按 Y 切换为代码。
3. 运行代码：选中单元格，按 Shift + Enter 运行并跳转到下一个单元格。
4. 保存：按 Ctrl + S 或点击右上角的保存图标。
5. 导出格式：支持将 Notebook 导出为 HTML、PDF、Python 脚本等多种格式。

总结

本文详细介绍了 Jupyter Notebook 在 Windows、Linux 和 macOS 系统下的安装方法，涵盖了 Anaconda 和 pip 两种主流安装方式，并提供了常见的故障排查方案和高级配置技巧。通过这些步骤，用户可以快速搭建起适合数据分析和机器学习开发的交互式环境。