Jupyter Notebook仅在base环境可用，其他环境启动页面空白求助
2026-5-12
解决方案：多Conda环境下Jupyter Notebook页面空白问题
我之前踩过几乎一模一样的坑，折腾了好一阵才找到根源，给你几个针对性的方案，按顺序试试：
1. 确保目标环境安装并注册了ipykernel
这是最常见的原因——Jupyter需要ipykernel来连接非base的conda环境，如果环境里没装，就会出现页面加载异常但控制台无报错的情况：
- 激活你的目标环境：
conda activate XXX - 安装ipykernel：
conda install ipykernel -y - 将该环境注册到Jupyter的内核列表：
python -m ipykernel install --user --name XXX --display-name "Python (XXX)" - 关闭所有Jupyter进程，重新启动试试
2. 重置Jupyter配置文件
有时候配置文件损坏或者路径冲突会导致页面加载异常，重置配置可以解决：
- 先关掉所有正在运行的Jupyter窗口和进程
- 在base环境执行：
jupyter notebook --generate-config，如果提示是否覆盖现有配置，输入y确认 - 再尝试在目标环境启动Jupyter，访问页面
3. 更换端口+清空浏览器缓存
虽然你试过换localhost，但端口缓存或浏览器缓存可能还在作祟：
- 启动Jupyter时指定新端口：
jupyter notebook --port=8890 - 用浏览器的无痕模式访问
localhost:8890/tree，或者手动清空缓存（Ctrl+Shift+Delete）后再访问
4. 检查conda环境的PATH变量冲突
如果目标环境的PATH里Anaconda相关路径不在最前面，可能导致Jupyter加载错误的依赖：
- 激活目标环境后，执行
echo %PATH%（Windows）或echo $PATH（Linux/Mac） - 确认输出最前面是你的目标环境的conda路径（比如
C:\Users\XXX\anaconda3\envs\XXX\Scripts） - 如果不是，可以执行
conda config --add envs_dirs "你的conda环境路径"来调整优先级
5. 尝试用Jupyter Lab替代Notebook
有时候Notebook的页面渲染问题在Jupyter Lab里不会出现，可以试试：
- 激活目标环境：
conda activate XXX - 安装Jupyter Lab：
conda install jupyterlab -y - 启动：
jupyter lab，访问对应的页面
如果以上方案都不行，可以试试删除目标环境下的.ipynb_checkpoints文件夹（如果有的话），或者创建一个全新的conda环境测试，排除环境本身的问题。
内容的提问来源于stack exchange，提问作者Andry
相关产品推荐
相关产品推荐
