You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

WSL2中Jupyter Notebook/Lab启动加载缓慢,需按CTRL+C恢复正常

解决WSL2下Jupyter Notebook/Lab加载缓慢及xdg-open错误问题

核心解决方案

1. 临时禁用自动打开浏览器

启动Jupyter时添加--no-browser参数,跳过自动打开浏览器的步骤:

jupyter notebook --no-browser
# Jupyter Lab执行此命令
jupyter lab --no-browser

启动后手动复制终端输出的URL(如http://localhost:8888/?token=xxx)到Windows浏览器打开,页面会立刻加载完成。

2. 永久禁用自动打开浏览器

生成并修改Jupyter配置文件,永久关闭自动打开行为:

  1. 生成配置文件:
    jupyter notebook --generate-config
    # Jupyter Lab执行此命令
    jupyter lab --generate-config
    
  2. 打开对应配置文件(路径通常为~/.jupyter/jupyter_notebook_config.py或~/.jupyter/jupyter_lab_config.py),找到c.NotebookApp.open_browser(Lab为c.LabApp.open_browser),修改为:
    c.NotebookApp.open_browser = False
    # Lab对应的配置项
    # c.LabApp.open_browser = False
    

保存后,后续启动Jupyter将默认不自动打开浏览器。

3. 修复xdg-open跨系统调用问题(解决根本触发原因)

WSL2内的xdg-open无法直接调用Windows浏览器,导致错误,可通过以下两种方式修复:

  • 方式一:指定Windows浏览器为默认
    在~/.bashrc或~/.zshrc中添加环境变量(以Chrome为例):

    export BROWSER="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
    

    执行source ~/.bashrc(zsh用户执行source ~/.zshrc)使配置生效,此后xdg-open会直接调用Windows的Chrome打开URL,不会生成无效的本地HTML文件。

  • 方式二:安装WSL专用工具wslu
    安装wslu工具处理WSL与Windows的交互:

    sudo apt update && sudo apt install wslu
    

    安装后xdg-open会自动适配WSL环境,正确调用Windows应用打开URL。

问题原因

WSL2本身无独立图形界面,Jupyter启动时默认调用Linux的xdg-open尝试打开浏览器,但该工具无法直接与Windows浏览器交互,转而尝试生成本地引导HTML文件,这个过程在跨文件系统交互中出现超时或失败,导致Jupyter卡住等待,页面加载延迟;按下Ctrl+C会中断xdg-open的调用进程,Jupyter恢复正常运行。

内容的提问来源于stack exchange,提问作者LucaLopes

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.08.13 14:55:14