官网:Project Jupyter

基础说明

虽然jupyter系列产品以python包的形式安装,但jupyter本质上是一个web端IDE工具,并不是python的功能模块,和python有千丝万缕的联系的同时,本身也是一个独立的、功能明确的软件
jupyter有两个产品,一个是notebook,另一个是lab。notebook是一个交互式的、可以让代码和说明文档穿插放置的web GUI,而lab是notebook的进化版,几乎相当于一个可以运行notebook的web版VS Code。此外它还支持预览csv/html/md/jpg/png/gif/pdf
程序员可以利用jupyter调试代码并穿插着写复杂的注释,非专业人士也可以把它当成GUI程序,简单修改一些参数后运行。

安装

必做

jupyter的依赖项非常多,且都有指定版本,因此极力推荐使用conda(见本项目“python安装与虚拟环境”小节)单独为jupyterlab设置一个环境

#强烈建议使用python3.7以上环境,配合bamboolib,使非开发者也能用GUI操作pandas
conda create --name jupyter python=3.9
conda activate jupyter
pip install jupyterlab
#生成设置文件
jupyter lab --generate-config
# 将生成%USERPROFILE%\.jupyter\jupyter_lab_config.py文件

打开该文件,在第一行加入c.ServerApp.root_dir='D:/Github/Jupyter',该目录必须存在。这个地址就是jupyter的工作目录。以后在jupyter中写代码时,当前工作目录、import和读取文件数据等功能,采用的相对路径和正常的python项目是一样的。

可选

正常情况下,启动jupyter时会自动打开系统默认浏览器。若需要指定浏览器打开,则在config文件中加入如下代码

import webbrowser
webbrowser.register("chrome", None,webbrowser.GenericBrowser("C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe"))
c.NotebookApp.browser = 'chrome'

文件中还有非常多的其他设置,若有需要,可参考官网修改。

启动

推荐使用electerm/tabby/windows terminal等高级终端启动,在终端中先conda activate jupyter再输入jupyter-lab启动程序,可以采用高级终端的“快速命令”功能启动

插件与其他管理

jupyterlab有类似于vscode的插件功能。以代码自动补全插件为例,在界面上点击安装,按照提升在命令行中输入命令,只不过推荐把conda install换成pip install。有些插件可以自动安装,有些必须要输入命令安装。

conda install -c conda-forge jupyterlab-lsp

内核的添加与删除

conda install ipykernel
# 查看内核列表
jupyter kernelspec list
# 删除内核
jupyter kernelspec remove $kernelname

bamboolib(pandas的GUI库)的安装,参考了bamboolib官网。注意该项目安装时间较长。

# 假设当前已经激活了jupyter虚拟环境,并已安装jupyterlab
pip install ipykernel
python -m ipykernel install --user --name bamboolib
pip install --upgrade bamboolib --user
python -m bamboolib install_nbextensions
python -m bamboolib install_labextensions
pip install matplotlib