新机器启动Jupyter Notebook显示空白页问题求助

可能原因 #

• 仅安装IPython未完整部署Jupyter核心组件：IPython是Jupyter的依赖项，但Jupyter Notebook需要独立的专属包支持，单独安装IPython无法满足完整Notebook服务的运行需求
• 安装过程权限不足：使用普通用户权限执行pip安装时，部分系统级路径无法写入，导致核心配置文件缺失
• Jupyter配置文件未正确生成：首次启动时未自动生成必要配置文件，或生成过程被中断
• 浏览器缓存干扰：浏览器缓存了无效的Jupyter资源链接，导致页面加载时请求错误资源

解决步骤 #

1. 完整重装Jupyter Notebook组件 #

先卸载现有可能不完整的相关包，再重新安装完整组件：

pip uninstall -y jupyter jupyter-core jupyter-notebook ipython
pip install jupyter notebook

注：若使用虚拟环境，需先激活环境再执行命令；全局安装可添加--user参数规避权限问题：pip install --user jupyter notebook

2. 手动生成Jupyter配置文件 #

执行以下命令强制生成配置文件：

jupyter notebook --generate-config

命令执行后会输出配置文件路径，确认文件已生成即可。

3. 清理浏览器缓存 #

打开浏览器设置清理当前站点缓存，或直接按Ctrl+Shift+R强制刷新页面，避免旧缓存导致的资源请求错误。

4. 检查安装路径权限（可选） #

若为全局安装，确认Python的site-packages目录具备读写权限：

# 查看site-packages路径
python -c "import site; print(site.getsitepackages())"
# 检查权限（Linux/macOS环境示例）
ls -l 上述输出的路径之一

若权限不足，可切换至管理员用户执行安装，或使用--user参数将包安装到用户专属目录。

5. 验证基础功能 #

先启动IPython确认基础环境正常：

ipython

退出IPython后重新启动Jupyter Notebook：

jupyter notebook

此时观察终端是否仍有404错误，浏览器页面是否正常加载。

内容的提问来源于stack exchange，提问作者Morcus