[jupyter]

以下是在项目的 .venv 虚拟环境中配置 JupyterLab 并使用的完整命令套装，按步骤执行即可：

1. 进入项目目录并创建/激活虚拟环境

# 进入你的项目目录（替换为实际路径）
cd /path/to/your/project# 用 uv 创建 .venv 虚拟环境（如果还没创建）
uv venv .venv# 激活虚拟环境（根据系统选择）
# Linux/macOS
source .venv/bin/activate
# Windows（PowerShell）
.venv\Scripts\Activate.ps1
# Windows（命令提示符）
.venv\Scripts\activate.bat

2. 在虚拟环境中安装必要工具

# 安装 JupyterLab 和内核注册工具 ipykernel
uv pip install jupyterlab ipykernel

3. 将当前虚拟环境注册为 Jupyter 内核

# 注册内核（替换括号中的名称为你的项目名，方便识别）
python -m ipykernel install \--user \--name="proj_venv" \  # 内核内部标识（比如：项目名_venv，避免重名）--display-name="MyProject (.venv)"  # Jupyter 界面显示的名称（清晰标注项目）

4. 启动 JupyterLab 并使用内核

# 启动 JupyterLab（会自动在浏览器打开）
jupyter lab

• 在 Jupyter 界面中，新建 Notebook 时，右上角选择你注册的内核（如 MyProject (.venv)）。
• 已有 Notebook 可通过顶部菜单「Kernel」→「Change Kernel」切换到该内核。

5. （可选）后续管理命令

查看已注册的所有内核

jupyter kernelspec list

删除某个内核（用内部标识 --name 的值）

jupyter kernelspec remove proj_venv  # 替换为你的内核内部名称

退出虚拟环境（不需要时）

deactivate

按这套命令操作，就能确保 JupyterLab 完全使用项目的 .venv 环境，所有安装的包均可正常调用，且环境隔离清晰~