回绝似是而非：Jupyter Notebook 装置、运行和工作文件夹配置教程

一、Jupyter Notebook 简介

Jupyter Notebook 是基于网页的用于交互计算的应用程序。其可被利用于全过程计算：开发、文档编写、运行代码和展现后果。——Jupyter Notebook 官网介绍

简而言之，Jupyter Notebook 是网页模式的编程环境，能够在网页中间接编写代码和运行代码，代码的运行后果也会间接在代码块下显示。如在编程过程中须要编写阐明文档，可在同一个页面中间接编写，便于及时作出阐明和解释。

二、Jupyter Notebook 装置

1、装置形式—应用 Anaconda 装置

倡议通过装置 Anaconda 来解决 Jupyter Notebook 的装置问题，因为装置 Anaconda 曾经主动装置了 Jupter Notebook 及其他工具、Python 解释器以及超过 180 个 Python 迷信包及其依赖项，对是否提前装置了适合版本的 Python 不必关怀。
进入 Anaconda 的官网下载页面抉择适宜版本、下载安装文件，便能够跟装置惯例的软件一样装置。本文示例，抉择了 Anaconda3-2020.11-Windows-x86_64 这个版本，并在 Windows 10 环境中装置。

2、装置过程中的无关选项的抉择

双击下载的安装文件，装置便开始，根本是一路选默认选项、点击 Next，但有几个选项须阐明或作出正确抉择。

a、上面页面上“Just me”和“All Users”两个选项都是能够的，不过选“All Users”须要管理员权限，如果装置后仅本人应用的话选默认（“Just me”）就行。

b、上面页面上的两个复选框都须选中，以便在 Windows 零碎中增加 Anaconda 的环境变量和注册装置的 Anaconda 作为默认 Python 解释器；如果不选中，在 cmd、Windows PowerShell 等命令行窗口无奈启动 Anaconda、Jupyter NoteBook，只能在 Windows 开始菜单上先启动 Anaconda，也不会注册装置的 Anaconda 作为 Python 解释器。

c、如果在装置 Anaconda 前曾经装置同一版本 Python 解释器，在选中下面页面的第二个选项（注册 Anaconda 作为默认 Python 解释器）后，会呈现上面的提示信息，确定便可、Anaconda 便作为默认的 Python 解释器。

d、最初装置实现，在实现页面默认选中两个选项，疏导用户进入 Anaconda 版本领导网页和开始网页，按默认选项或勾销选中都没影响，点击 Finish 装置便实现了。

三、Jupyter Notebook 运行

Anaconda 装置实现后，能够多种形式启动并运行 Jupyter Notebook，因为本文不波及 Anaconda，所以不钻研在 Anaconda Navigator 中启动运行 Jupyter Notebook，上面仅阐明以下两种形式：命令行窗口和 Jupyter Notebook 快捷方式。

1、命令行窗口运行 Jupyter Notebook

a、关上 cmd（也称命令提示符）窗口。

b、在 cmd 窗口输出如下命令并回车。

jupyter notebook

c、Jupyter Notebook 即启动。

d、Jupyter Notebook 启动后在浏览器中关上了 Jupyter 工作网页、并在网页中关上了默认本地工作文件夹：C:\Users\Administrator。

e、在 Windows PowerShell 以及 Anaconda 自带的 Anaconda Prompt、Anaconda Powershell Prompt 等命令行窗口启动运行 Jupyter Notebook 状况根本与上述统一，只是在 Anaconda 中启动 Jupyter Notebook 曾经激活了 Anaconda 根本的 Python 环境（差别处在下图曾经标识），至于为什么要激活、怎么激活 Anaconda 的 Python 环境，本文不予探讨。

2、快捷方式运行 Jupyter Notebook

在 Windows 10 开始菜单，顺次关上 Anaconda→Jupyter Notebook，即启动运行了 Jupyter Notebook，与在命令行窗口启动运行 Jupyter Notebook 完全一致。也能够把这个快捷方式发送到桌面，点击桌面上的 Jupyter Notebook 快捷方式有同样的成果。

四、Jupyter Notebook 工作文件夹配置（干货）

按上述形式启动运行 Jupyter Notebook 后，Jupyter Notebook 网页关上的是默认的本地工作文件夹，个别为 Windows 用户文件夹，本文示例是：C:\Users\Administrator。在该文件夹中个别曾经有很多子文件夹和其余文件，不是咱们现实的工作文件夹。那么怎么设定咱们现实的本地工作文件夹呢？网上对这个问题的探讨十分多，大家总结了 N 多办法，但很多办法没有阐明原理，似是而非。本文在这一章节予以具体阐明，也是写本文的最大动机。

1、Jupyter Notebook 配置文件生成

a、Jupyter Notebook 装置后，如果按默认配置运行，是不须要配置文件、启动运行后也不会生成配置文件，要生成可批改的配置文件，须要在 cmd 窗口输出以下命令并回车。

jupyter notebook --generate-config

b、该命令运行后即在 Windows 用户文件夹 C:\Users\Administrator 生成了子文件夹.jupyter，并在其中生成了 Jupyter Notebook 配置文件：jupyter_notebook_config.py，配置文件中配置设定为默认配置。

c、如果以前生成过配置文件，则输出上述命令后，会询问是否笼罩原有的配置文件，默认不笼罩，除非你输出 y 后回车即以默认配置笼罩原有配置文件。

2、设定命令行窗口运行 Jupyter Notebook 的工作文件夹

即便 Jupyter Notebook 配置文件生成后，因为配置文件中设定的配置为默认设定，所以关上的本地工作文件夹认为默认工作文件夹，个别为 Windows 用户文件夹。如何批改配置文件，以启动现实的本地工作文件夹呢？

a、用 Notepad++ 等文本编辑器关上曾经生成的配置文件jupyter_notebook_config.py。

b、在编辑器中通过查找关键词 c.NotebookApp.notebook_dir 来查找到配置文件中的本地工作文件夹设定语句。

c、在该语句的引号 '' 两头输出（为了防止过错，最好复制）现实的本地工作文件夹的门路。但因为配置文件是个 Python 脚本文件，在 Python 解释器中把 \ 解释为本义符，须要对门路作适当批改，比方我的现实本地工作文件夹的门路是：C:\Users\Administrator\OneDrive\WorkSpace\Jupyter，须要批改成C:\\Users\\Administrator\\OneDrive\\WorkSpace\\Jupyter，否则解释器在解释该语句时会呈现语法错误，配置不失效，如下图；

同理，为了能让 Python 解释器正确解释该语句，须要把句首的 # 以及前面的空格（必须）全副删除，如果（哪怕还有一个）空格不删除，解释器在解释该语句时就会呈现缩进谬误，配置不失效、关上的本地工作文件夹依然为默认本地工作文件夹，如下图。

• 有些网络文章，只强调在引号间复制黏贴现实的本地工作文件夹门路，未强调对门路进行批改，导致读者按文章要求做后，本地工作文件夹并未扭转，令读者一头雾水。
• 因为配置文件是 Python 脚本文件，而 Python 解释器特别强调代码缩进地位的准确性，无论语句多缩进还是未按要求缩进，解释器均会报缩进谬误（IndentationError），脚本不能失常被解释和执行，所以须要特别强调“# 前面的空格（必须）全副删除”，免得少删除空格导致缩进谬误。

d、经试验，把配置文件中本地工作文件夹设定语句改成以下三种模式，成果完全一致。

c.NotebookApp.notebook_dir = 'C:\\Users\\Administrator\\OneDrive\\WorkSpace\\Jupyter'  #  正确写法 1

c.NotebookApp.notebook_dir = r'C:\Users\Administrator\OneDrive\WorkSpace\Jupyter'    #  正确写法 2

c.NotebookApp.notebook_dir = 'C:/Users/Administrator/OneDrive/WorkSpace/Jupyter'    #  正确写法 3

e、通过生成配置文件、并按下面要求批改该文件 jupyter_notebook_config.py 后，在命令行窗口启动运行 Jupyter Notebook，即在 Jupyter 工作网页关上了现实的本地工作文件夹，本文示例为文件夹：C:\Users\Administrator\OneDrive\WorkSpace\Jupyter，外面尚无任何代码文件、其余文件和子文件夹。

3、设定快捷方式运行 Jupyter Notebook 的工作文件夹

按上述要求批改了配置文件后，快捷方式运行 Jupyter Notebook 还是关上默认本地工作文件夹，须进一步设定。

a、关上 Windows 开始菜单→关上 Jupyter Notebook 快捷方式右键菜单→左键单击“属性（R）”项即关上了 Jupyter Notebook 快捷方式属性对话框。

b、在 Jupyter Notebook 快捷方式属性对话框的“指标 (T)”项开端删除"%USERPROFILE%/" 后确定，Jupyter Notebook 快捷方式启动运行 Jupyter Notebook 即能关上现实的本地工作文件夹。

• Jupyter Notebook 快捷方式属性对话框的“指标 (T)”项开端的代码"%USERPROFILE%/" 作用是强制关上 Windows 用户文件夹作为本地工作文件夹，删除该局部代码后配置文件设定的本地工作文件夹失效。
• “指标 (T)”项开端的代码"%USERPROFILE%/" 删除后，“起始地位 (S)”项内容是什么无关紧要、配置文件都能失效；“指标(T)”项开端的代码"%USERPROFILE%/" 不删除，“起始地位(S)”项内容是什么无关紧要、配置文件都不失效。
• 有些网文，试图对下面两项做各种花式的组合批改，都是徒劳无益的。

至此，Jupyter Notebook 装置、运行及本地工作文件夹配置实现。至于怎么使用、在期间工作，待咱们在下一篇文章见。

Enjoy yourself.