必须在激活的虚拟环境中安装jupyter和ipykernel并注册内核，执行pip install jupyter ipykernel后运行python -m ipykernel install --user --name myenv --display-name "Python (myenv)"，再通过notebook界面选择该内核并验证sys.executable路径是否指向venv。
确认 venv 已激活且 pip 可用
在启动 Jupyter 前，必须确保你处在目标虚拟环境中——否则 jupyter notebook 会装到系统 Python 或其他环境里，导致 kernel 不匹配、包找不到。运行 which python（macOS/Linux）或 where python（Windows）确认路径含 venv 或 Scripts；再执行 pip list 看是否为空或只有 pip、setuptools——这是干净的起点。
在 venv 中安装 jupyter 和 ipykernel
只装 jupyter 不够，还必须装 ipykernel，否则 notebook 启动后看不到你的 venv 作为可选 kernel。执行：
pip install jupyter ipykernel
接着把当前 venv 注册为 notebook 的一个内核：
python -m ipykernel install --user --name myenv --display-name "Python (myenv)"
-
--name是内核标识符（纯字符串，用于命令行管理），建议与 venv 文件夹名一致 -
--display-name是 notebook 界面里显示的名字，支持空格和括号 -
--user表示写入用户级 kernel 目录，避免权限问题；不要加--system
启动 notebook 并验证 kernel 是否生效
直接运行 jupyter notebook，打开浏览器后新建 notebook，点击右上角 kernel 名称（默认是 Python 3），下拉菜单里应出现你设的 Python (myenv)。选中它，运行 import sys; print(sys.executable) —— 输出路径必须指向你的 venv 的 python 可执行文件，而不是系统路径。
立即学习“Python免费学习笔记（深入）”；
常见卡点：
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- 启动后 kernel 显示 “dead” 或反复重启：多半是
ipykernel版本与jupyter不兼容，尝试pip install "ipykernel（尤其在 Python 3.8 及更早环境） - 菜单里没看到自定义 kernel：检查
python -m ipykernel install是否真在激活的 venv 中执行；也可手动检查jupyter kernelspec list - notebook 报错
ModuleNotFoundError：说明代码用了未在该 venv 中安装的包，别用系统 pip 装，始终在激活状态下用pip install
删除或更新 kernel 的安全操作
重命名或删错 kernel 不影响 venv 本身，但操作要通过 jupyter kernelspec 命令，而非手动删文件夹。
查看所有 kernel：
jupyter kernelspec list
删除某个 kernel（例如叫 myenv）：
jupyter kernelspec uninstall myenv
如果想换 display name，不能改已注册的，只能先卸载再重装——没有就地编辑机制。
注意：--user 安装的 kernel 存在 ~/.local/share/jupyter/kernels/（Linux/macOS）或 %USERPROFILE%\AppData\Roaming\jupyter\kernels\（Windows），但别手动删，容易残留 registry 信息导致 notebook 启动报错。
