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

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

---

1、Jupyter Notebook简介

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

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

2、Jupyter Notebook安装

一、安装方式—使用Anaconda安装

建议经过安装Anaconda来解决Jupyter Notebook的安装问题，由于安装Anaconda已经自动安装了Jupter Notebook及其余工具、Python解释器以及超过180个Python科学包及其依赖项，对是否提早安装了合适版本的Python不用关心。
进入Anaconda的官方下载页面选择适合版本、下载安装文件，即可以跟安装常规的软件同样安装。本文示例，选择了Anaconda3-2020.11-Windows-x86_64这个版本，并在Windows 10环境中安装。

二、安装过程当中的有关选项的选择

双击下载的安装文件，安装便开始，基本是一路选默认选项、点击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安装便完成了。

3、Jupyter Notebook运行

Anaconda安装完成后，能够多种方式启动并运行Jupyter Notebook，因为本文不涉及Anaconda，因此不研究在Anaconda Navigator中启动运行Jupyter Notebook，下面仅说明如下两种方式：命令行窗口和Jupyter Notebook快捷方式。

一、命令行窗口运行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环境，本文不予讨论。

二、快捷方式运行Jupyter Notebook

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

4、Jupyter Notebook工做文件夹配置（干货）

按上述方式启动运行Jupyter Notebook后，Jupyter Notebook网页打开的是默认的本地工做文件夹，通常为Windows用户文件夹，本文示例是：C:\Users\Administrator。在该文件夹中通常已经有不少子文件夹和其余文件，不是咱们理想的工做文件夹。那么怎么设定咱们理想的本地工做文件夹呢？网上对这个问题的讨论很是多，你们总结了N多方法，但不少方法没有说明原理，似是而非。本文在这一章节予以详细说明，也是写本文的最大动机。

一、Jupyter Notebook配置文件生成

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

jupyter notebook --generate-config

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

c、若是之前生成过配置文件，则输入上述命令后，会询问是否覆盖原有的配置文件，默认不覆盖，除非你输入y后回车即以默认配置覆盖原有配置文件。

二、设定命令行窗口运行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，里面尚无任何代码文件、其余文件和子文件夹。

三、设定快捷方式运行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.