上一篇                     
               
			  linux如何安装jupyter
- Linux
- 2025-07-18
- 4112
 Linux上安装Jupyter,可通过包管理器(如
 
 
apt、
 yum)或使用
 pip命令安装。
在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 --versionpip3 --version | 查看是否已安装Python 3和pip | 
| 安装Python和pip(以Ubuntu为例) | sudo apt updatesudo apt install python3sudo apt install python3-pip | 更新软件源并安装Python 3和pip | 
| 创建虚拟环境(可选) | python3 -m venv myenvsource myenv/bin/activate | 创建并激活虚拟环境 | 
| 安装Jupyter | pip3 install jupyter | 使用pip安装Jupyter | 
| 验证安装 | jupyter --version | 查看Jupyter版本,确认安装成功 | 
| 生成配置文件(可选) | jupyter notebook --generate-config | 生成默认配置文件 | 
| 设置密码(可选) | jupyter notebook password | 为Jupyter Notebook设置密码 | 
| 配置内核(如果有多个Python环境) | pip install ipykernelpython3 -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'。
 
- 可以编辑
 
  
			