jupyter使用虚拟环境

发布于:2025-06-20 ⋅ 阅读:(13) ⋅ 点赞:(0)

创建 Python 3.12 虚拟环境

conda create -n py312 python=3.12 -y

激活虚拟环境

conda activate py312

安装 Jupyter Lab

在激活的虚拟环境中安装 Jupyter Lab

conda install -c conda-forge jupyterlab -y
或者
pip install jupyterlab

将虚拟环境添加到 Jupyter 内核

为了在 Jupyter Lab 中使用这个虚拟环境,需要将其注册为内核


# 添加conda-forge 频道的镜像源
conda config --set custom_channels.conda-forge https://mirrors.tuna.tsinghua.edu.cn/anaconda/cloud/


conda install -c conda-forge ipykernel -y
# 或者
pip install ipykernel

# 对于 Python 内核,如果内核损坏,可重新安装:
pip install --force-reinstall ipykernel
python -m ipykernel install --user

然后将当前环境添加到 Jupyter:

python -m ipykernel install --user --name py312 --display-name "Python 3.12"

各部分解释

  1. python -m ipykernel

    • python -m:以模块方式运行 Python 模块
    • ipykernel:这是 Jupyter 的核心组件之一,负责 Python 内核的功能
  2. install

    • 这是 ipykernel 模块的子命令,表示要安装一个新的内核
  3. --user

    • 将内核安装在用户目录下(而不是系统全局目录)
    • 不需要管理员权限
    • 通常位置:
      • Linux/macOS: ~/.local/share/jupyter/kernels/
      • Windows: %APPDATA%\jupyter\kernels\
  4. --name py312

    • 指定内核的内部名称(用于系统识别)
    • 这是机器可读的标识符
    • 在 Jupyter 配置文件中会使用这个名称
  5. --display-name "Python 3.12"

    • 指定内核在 Jupyter 界面中显示的名称
    • 这是用户看到的友好名称
    • 可以包含空格和特殊字符

执行后的效果

  1. 会在 Jupyter 的内核目录中创建一个新目录(如 py312/
  2. 目录中包含:
    • kernel.json:内核配置,指定使用哪个 Python 解释器
    • 图标文件(可选)
  3. Jupyter 界面中会出现 “Python 3.12” 的可选内核

为什么需要这个步骤?

  • Jupyter 默认只使用它自己安装的 Python 环境
  • 通过这个命令,可以让 Jupyter 识别并使用你创建的 conda/venv 环境
  • 每个虚拟环境都需要单独注册为内核才能在 Jupyter 中使用

启动 Jupyter Lab

jupyter lab

在 Jupyter Lab 中使用虚拟环境

  1. 打开 Jupyter Lab 后,新建 Notebook 时可以选择 “Python 3.12” 内核
  2. 或者在已有的 Notebook 中,通过右上角的内核选择器切换到这个环境

验证环境

在 Notebook 中运行以下代码验证 Python 版本和环境:

import sys
print(sys.version)
!conda list

!conda list

  • 在 Jupyter Notebook 中执行 shell 命令,显示当前 conda 环境中安装的所有包及其版本
  • 如果不在 conda 环境中,可以用 !pip list 查看 pip 安装的包
import sys
print(sys.executable)  # 显示内核使用的 Python 路径
print("Hello, Kernel!")  # 测试输出

安装常用数据科学包

conda install -c conda-forge numpy pandas matplotlib scikit-learn seaborn

conda install -c 是 Conda 包管理器中常用的命令格式,用于从指定的频道(channel)安装软件包.

  • Conda 默认会搜索其默认频道(通常是 defaults)
  • 使用 -c 可以添加额外的频道来搜索软件包
conda install -c <频道名称> <包名>

常用频道包括:
conda-forge:社区维护的广泛软件包集合
anaconda:Anaconda 官方维护的频道
bioconda:生物信息学相关软件包
pytorch:PyTorch 相关软件包

对于最新或更全的软件包,推荐使用 conda-forge

jupyter内核

# 查看已安装的内核
jupyter kernelspec list
# 卸载内核
jupyter kernelspec uninstall py312

# 查看内核指定的Python环境位置
ipython kernelspec list

jupyter扩展

cmd后输入

常用扩展,安装完成后重启JupyterLab即可

# Draw.io 图形编辑
jupyter labextension install jupyterlab-drawio
# 安装所需语言的服务器
jupyter labextension install @krassowski/jupyterlab-lsp
#安装所需语言的服务器,例如,Python 语言服务器:
#pip install 'python-lsp-server[all]'
#使用 LSP 功能:
#打开代码文件或笔记本,LSP 功能会自动启用。
#代码自动补全、语法检查和文档提示等功能将会生效。

管理扩展

jupyter labextension list  # 查看已安装的扩展

# 安装Lab扩展:jupyter labextension install 扩展名
jupyter labextension install @jupyterlab/toc

# 卸载 
jupyter labextension uninstall @jupyterlab/toc
# 卸载Python包(如果有)
pip uninstall jupyterlab-drawio
pip uninstall ipydrawio

# 清理和重建
jupyter lab build  # 重建Lab
jupyter lab clean  # 清除构建缓存

# 禁用,而不用卸载
jupyter labextension disable @jupyterlab/toc

重置 JupyterLab 设置

jupyter lab clean --all
jupyter lab build

网站公告

今日签到

点亮在社区的每一天
去签到