回绝似是而非：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.