在Linux系统中安装Jupyter,一般需要先确保系统已安装Python和pip(Python包管理器),然后通过pip安装Jupyter相关包,并进行一些配置,以下是详细的安装步骤:
安装前的准备工作
-
检查Python和pip是否已安装
- 在终端中输入
python3 --version
和pip3 --version
命令,查看是否已安装Python 3和pip,如果未安装,需要先安装它们,不同的Linux发行版安装方式可能略有不同,以常见的Ubuntu为例,可以使用以下命令安装:sudo apt update
更新软件源列表。sudo apt install python3
安装Python 3。sudo apt install python3-pip
安装pip。
- 在终端中输入
-
创建虚拟环境(可选但推荐)
- 使用虚拟环境可以避免与其他Python项目产生依赖冲突,在终端中,导航到你希望创建虚拟环境的目录,例如
cd ~
进入用户主目录。 - 运行
python3 -m venv myenv
命令创建一个名为myenv
的虚拟环境。 - 激活虚拟环境,使用命令
source myenv/bin/activate
,激活后,终端提示符会发生变化,表明当前处于虚拟环境中。
- 使用虚拟环境可以避免与其他Python项目产生依赖冲突,在终端中,导航到你希望创建虚拟环境的目录,例如
安装Jupyter
-
使用pip安装Jupyter
- 如果未创建虚拟环境,直接在终端中运行
pip3 install jupyter
命令即可安装Jupyter,如果创建了虚拟环境,需要先激活虚拟环境,然后再运行该命令,安装过程会下载并安装Jupyter相关的依赖包。
- 如果未创建虚拟环境,直接在终端中运行
-
验证安装是否成功
- 安装完成后,在终端中输入
jupyter --version
命令,查看Jupyter的版本信息,确认安装是否成功。
- 安装完成后,在终端中输入
配置Jupyter
-
生成配置文件(可选)
- 首次启动Jupyter时,它会在用户主目录下生成一个默认的配置文件
jupyter_notebook_config.py
,你也可以手动生成配置文件,使用命令jupyter notebook --generate-config
,生成的配置文件包含了各种Jupyter的配置选项。
- 首次启动Jupyter时,它会在用户主目录下生成一个默认的配置文件
-
设置密码(可选)
- 为了安全起见,可以为Jupyter Notebook设置密码,在终端中运行
jupyter notebook password
命令,按照提示输入并确认密码,这会在~/.jupyter
目录下生成一个jupyter_notebook_config.json
文件,其中存储了加密后的密码。
- 为了安全起见,可以为Jupyter Notebook设置密码,在终端中运行
-
配置内核(如果有多个Python环境)
- 如果系统中安装了多个Python环境,你可能需要为Jupyter配置内核,以便在Notebook中选择使用特定的Python环境,确保你已经安装了
ipykernel
包,可以使用命令pip install ipykernel
进行安装。 - 在终端中运行
python3 -m ipykernel install --user --name=your_env_name --display-name="Your Env Name"
,将your_env_name
替换为你的Python环境名称,例如如果你使用的是虚拟环境myenv
,可以将其命名为myenv
,这样,在Jupyter Notebook的内核选项中就会出现你添加的内核。
- 如果系统中安装了多个Python环境,你可能需要为Jupyter配置内核,以便在Notebook中选择使用特定的Python环境,确保你已经安装了
启动Jupyter
-
启动Jupyter Notebook
- 在终端中,直接运行
jupyter notebook
命令即可启动Jupyter Notebook,这会在默认的浏览器中打开Jupyter Notebook的界面,显示当前目录下的文件和文件夹。
- 在终端中,直接运行
-
启动Jupyter Lab(可选)
- 如果你更喜欢Jupyter Lab的界面,可以运行
jupyter lab
命令启动Jupyter Lab,它的界面更加现代化,提供了更多的功能和灵活的布局。
- 如果你更喜欢Jupyter Lab的界面,可以运行
常见问题及解决方法
-
端口被占用
- 如果在启动Jupyter时遇到端口被占用的错误,可以在启动命令中指定其他端口,使用
jupyter notebook --port=8889
命令将Jupyter Notebook的端口设置为8889。
- 如果在启动Jupyter时遇到端口被占用的错误,可以在启动命令中指定其他端口,使用
-
无法连接到内核
- 这种情况可能是由于内核安装不正确或配置问题导致的,检查内核是否正确安装,可以尝试重新安装
ipykernel
和相关的Python环境,检查Jupyter的配置文件中内核相关的设置是否正确。
- 这种情况可能是由于内核安装不正确或配置问题导致的,检查内核是否正确安装,可以尝试重新安装
下面是一个简单的安装步骤表格归纳:
步骤 | 命令 | 说明 |
---|---|---|
检查Python和pip | python3 --version pip3 --version |
查看是否已安装Python 3和pip |
安装Python和pip(以Ubuntu为例) | sudo apt update sudo apt install python3 sudo apt install python3-pip |
更新软件源并安装Python 3和pip |
创建虚拟环境(可选) | python3 -m venv myenv source myenv/bin/activate |
创建并激活虚拟环境 |
安装Jupyter | pip3 install jupyter |
使用pip安装Jupyter |
验证安装 | jupyter --version |
查看Jupyter版本,确认安装成功 |
生成配置文件(可选) | jupyter notebook --generate-config |
生成默认配置文件 |
设置密码(可选) | jupyter notebook password |
为Jupyter Notebook设置密码 |
配置内核(如果有多个Python环境) | pip install ipykernel python3 -m ipykernel install --user --name=your_env_name --display-name="Your Env Name" |
安装ipykernel 并添加内核 |
启动Jupyter Notebook | jupyter notebook |
启动Jupyter Notebook |
启动Jupyter Lab(可选) | jupyter lab |
启动Jupyter Lab |
FAQs:
-
如何在Linux上卸载Jupyter?
- 如果使用pip安装的Jupyter,可以使用命令
pip3 uninstall jupyter
来卸载,如果安装在虚拟环境中,需要先激活虚拟环境,然后再运行卸载命令。
- 如果使用pip安装的Jupyter,可以使用命令
-
如何更改Jupyter Notebook的默认工作目录?
- 可以编辑
jupyter_notebook_config.py
配置文件,找到c.NotebookApp.notebook_dir
选项,将其值修改为你想要设置的默认工作目录路径,如果你想将默认工作目录设置为/home/user/myworkspace
,可以将该选项修改为c.NotebookApp.notebook_dir = '/home/user/myworkspace'
。
- 可以编辑
原创文章,发布者:酷盾叔,转转请注明出处:https://www.kd.cn/ask/66547.html