[jupyter]
以下是在項目的 .venv 虛擬環(huán)境中配置 JupyterLab 并使用的完整命令套裝,按步驟執(zhí)行即可:
1. 進入項目目錄并創(chuàng)建/激活虛擬環(huán)境
# 進入你的項目目錄(替換為實際路徑)
cd /path/to/your/project
# 用 uv 創(chuàng)建 .venv 虛擬環(huán)境(如果還沒創(chuàng)建)
uv venv .venv
# 激活虛擬環(huán)境(根據(jù)系統(tǒng)選擇)
# Linux/macOS
source .venv/bin/activate
# Windows(PowerShell)
.venv\Scripts\Activate.ps1
# Windows(命令提示符)
.venv\Scripts\activate.bat
2. 在虛擬環(huán)境中安裝必要工具
# 安裝 JupyterLab 和內(nèi)核注冊工具 ipykernel
uv pip install jupyterlab ipykernel
3. 將當(dāng)前虛擬環(huán)境注冊為 Jupyter 內(nèi)核
# 注冊內(nèi)核(替換括號中的名稱為你的項目名,方便識別)
python -m ipykernel install \
--user \
--name="proj_venv" \ # 內(nèi)核內(nèi)部標識(比如:項目名_venv,避免重名)
--display-name="MyProject (.venv)" # Jupyter 界面顯示的名稱(清晰標注項目)
4. 啟動 JupyterLab 并使用內(nèi)核
# 啟動 JupyterLab(會自動在瀏覽器打開)
jupyter lab
- 在 Jupyter 界面中,新建 Notebook 時,右上角選擇你注冊的內(nèi)核(如
MyProject (.venv))。 - 已有 Notebook 可通過頂部菜單「Kernel」→「Change Kernel」切換到該內(nèi)核。
5. (可選)后續(xù)管理命令
查看已注冊的所有內(nèi)核
jupyter kernelspec list
刪除某個內(nèi)核(用內(nèi)部標識 --name 的值)
jupyter kernelspec remove proj_venv # 替換為你的內(nèi)核內(nèi)部名稱
退出虛擬環(huán)境(不需要時)
deactivate
按這套命令操作,就能確保 JupyterLab 完全使用項目的 .venv 環(huán)境,所有安裝的包均可正常調(diào)用,且環(huán)境隔離清晰~

浙公網(wǎng)安備 33010602011771號