如何设置Jupyter Notebook默认在Chrome无痕模式下打开

常见问题原因 #

• 配置项不匹配当前Jupyter版本：c.ServerApp.browser为Jupyter Server/Notebook 7.x+ 适用参数，Notebook 6.x及更早版本需使用c.NotebookApp.browser
• Chrome路径填写错误：部分设备Chrome安装在C:/Program Files (x86)或用户目录AppData下，路径错误会触发默认浏览器 fallback
• 路径未加引号处理：路径含空格时系统解析命令会出错，导致自定义浏览器注册失败
• 配置文件位置错误：修改的并非Jupyter实际加载的配置文件

修复步骤 #

1. 确认配置文件存放路径
   运行终端命令jupyter --config-dir，输出的目录即为配置文件的正确存放位置，确保你修改的jupyter_notebook_config.py在该目录下。
2. 确认Chrome实际安装路径
   右键Chrome桌面快捷方式，点击「属性」，复制「目标」栏中的完整路径备用，注意区分Program Files和Program Files (x86)目录。
3. 修改配置文件内容
   将原有配置替换为以下内容，替换其中的Chrome路径为你上一步复制的路径，同时可同时配置两个版本的参数兼容不同Jupyter版本：

   import webbrowser
   # 注意路径外层加r避免转义，路径自身加双引号处理空格
   chrome_path = r'"C:/Program Files/Google/Chrome/Application/chrome.exe" --incognito %s'
   webbrowser.register('incognito-chrome', None, webbrowser.GenericBrowser(chrome_path))
   # 兼容旧版Notebook
   c.NotebookApp.browser = 'incognito-chrome'
   # 兼容新版Jupyter Server/Notebook
   c.ServerApp.browser = 'incognito-chrome'
   

4. 临时测试验证
   若修改配置后仍不生效，可直接在启动命令中指定浏览器参数快速验证：

   jupyter notebook --browser="C:\Program Files\Google\Chrome\Application\chrome.exe --incognito %s"
   

   若该命令可正常打开无痕模式Chrome，则说明配置文件未正确加载，检查是否存在注释遗漏、路径拼写错误问题即可。

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