基础说明
虽然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