JupyterLab桌面端修改Home路径后提示目录不存在如何解决？

报错根因 #

该报错由JupyterLab桌面版默认启动参数与配置文件规则冲突、路径格式解析异常导致。

修复步骤 #

• 第一步：修正root_dir路径格式
  Windows系统下配置路径时请勿保留末尾的路径分隔符，以下两种格式均可：

  c.ServerApp.root_dir = 'C:/Users/Username/Desktop'
  c.ServerApp.root_dir = 'C:\\Users\\Username\\Desktop'
  

  末尾多余的分隔符会导致桌面版解析路径时生成空字符串后缀，触发目录不存在报错。另外注意配置的路径中不要包含中文、空格或特殊字符，避免路径解析异常。
• 第二步：避免启动参数覆盖配置
  右键点击JupyterLab桌面版的快捷方式，选择「属性」，查看「目标」输入框中的内容，删除末尾附加的--notebook-dir=%U、%h等自动指定工作目录的参数，避免启动参数覆盖配置文件中的root_dir规则。
• 第三步：清除残留缓存
  依次打开以下两个目录，删除其中的workspaces文件夹，清除桌面版保存的历史路径缓存：
  • C:\Users\你的用户名\.jupyter\lab\
  • C:\Users\你的用户名\AppData\Roaming\jupyter\lab\
• 第四步：验证打开逻辑
  先手动启动JupyterLab桌面版，确认首页无报错后，右键点击任意.ipynb文件，选择「打开方式」，绑定到JupyterLab桌面版主程序，后续双击即可正常打开文件。

可选补充配置 #

如果修复后仍偶发报错，可在jupyter_lab_config.py中追加以下配置，禁用默认路径跳转逻辑：
c.LabApp.default_url = '/lab'

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