jupyter notebook如何使用虚拟环境?

在Jupyter Notebook中使用虚拟环境可以让你在不同项目中使用不同的Python环境和依赖包。以下是详细的设置方法：

方法一：使用ipykernel（推荐）

1. 创建并激活虚拟环境

# 创建虚拟环境 python -m venv myenv # 激活虚拟环境 # Windows: myenv\Scripts\activate # macOS/Linux: source myenv/bin/activate

2. 安装ipykernel

在激活的虚拟环境中安装：

pip install ipykernel

3. 将虚拟环境添加到Jupyter

python -m ipykernel install --user --name=myenv --display-name="Python (myenv)"

• --name: 内核名称（内部标识）

• --display-name: 在Jupyter界面中显示的名称

4. 启动Jupyter Notebook

jupyter notebook

在Notebook界面中，通过菜单Kernel→Change kernel→ 选择你创建的虚拟环境。

方法二：直接安装jupyter到虚拟环境

1. 创建并激活虚拟环境

python -m venv myenv source myenv/bin/activate # 或 Windows: myenv\Scripts\activate

2. 在虚拟环境中安装jupyter

pip install jupyter

3. 启动Jupyter

jupyter notebook

这样启动的Jupyter会自动使用当前虚拟环境的Python解释器。

方法三：使用conda环境

如果你使用Anaconda/Miniconda：

1. 创建conda环境

conda create -n myenv python=3.9 conda activate myenv

2. 安装ipykernel

conda install ipykernel # 或者 pip install ipykernel

3. 添加到Jupyter

python -m ipykernel install --user --name=myenv --display-name="Python (myenv)"

管理内核

查看已安装的内核

jupyter kernelspec list

删除内核

jupyter kernelspec uninstall myenv

验证环境

在Notebook中运行以下代码验证当前环境：

import sys print(sys.executable) # 显示Python解释器路径 print(sys.version) # 显示Python版本 # 检查已安装的包 !pip list

常见问题解决

1. 内核启动失败

如果内核无法启动，尝试重新安装ipykernel：

pip install --upgrade ipykernel python -m ipykernel install --user --force

2. 包导入错误

确保在正确的虚拟环境中安装了所需的包，并在添加内核前激活该环境。

3. 多个Python版本

如果使用多个Python版本，明确指定python路径：

/path/to/python -m ipykernel install --user --name=myenv

最佳实践建议

1. 为每个项目创建独立的虚拟环境

2. 使用明确的显示名称区分不同环境

3. 定期清理不需要的内核：使用jupyter kernelspec list和jupyter kernelspec uninstall

4. 在requirements.txt或environment.yml中记录依赖

这样设置后，你就可以在Jupyter Notebook中轻松切换不同的Python虚拟环境了。