MacOS虚拟环境中Jupyter Notebook启动空白问题求助

问题背景 #

在Mac上通过python.org包安装了Python3.12，同时配置了pip、Homebrew，以及Math、Pandas、Numpy、Jupyter Lab/Notebook等包。最初在Documents目录运行Jupyter Notebook可正常显示文件目录，因安装数学库时遇到问题，转而在桌面创建名为pythonpro的venv虚拟环境。激活该环境后启动Jupyter Notebook，界面空白，无文件目录及终端入口，使用python -m jupyter notebook启动同样无效。

环境配置检查输出 #

Last login: Tue Mar  5 12:39:35 on ttys000
➜  ~ which -a python3
/Library/Frameworks/Python.framework/Versions/3.12/bin/python3
/usr/local/bin/python3
/usr/bin/python3
➜  ~ ls -l /usr/bin/python*
-rwxr-xr-x  76 root  wheel  168160 Feb  2 18:19 /usr/bin/python3
➜  ~ ls -l /usr/local/bin/python*
lrwxr-xr-x  1 root  wheel  70 Feb 23 12:14 /usr/local/bin/python3 -> ../../../Library/Frameworks/Python.framework/Versions/3.12/bin/python3
lrwxr-xr-x  1 root  wheel  77 Feb 23 12:14 /usr/local/bin/python3-config -> ../../../Library/Frameworks/Python.framework/Versions/3.12/bin/python3-config
lrwxr-xr-x  1 root  wheel  78 Feb 23 12:14 /usr/local/bin/python3-intel64 -> ../../../Library/Frameworks/Python.framework/Versions/3.12/bin/python3-intel64
lrwxr-xr-x  1 root  wheel  73 Feb 23 12:14 /usr/local/bin/python3.12 -> ../../../Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12
lrwxr-xr-x  1 root  wheel  80 Feb 23 12:14 /usr/local/bin/python3.12-config -> ../../../Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12-config
lrwxr-xr-x  1 root  wheel  81 Feb 23 12:14 /usr/local/bin/python3.12-intel64 -> ../../../Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12-intel64
➜  ~ ls -l /Library/Frameworks/Python.framework/Versions/3.12/bin/python*
lrwxrwxr-x  1 root  admin      10 Feb 23 12:14 /Library/Frameworks/Python.framework/Versions/3.12/bin/python3 -> python3.12
lrwxrwxr-x  1 root  admin      17 Feb 23 12:14 /Library/Frameworks/Python.framework/Versions/3.12/bin/python3-config -> python3.12-config
lrwxrwxr-x  1 root  admin      18 Feb 23 12:14 /Library/Frameworks/Python.framework/Versions/3.12/bin/python3-intel64 -> python3.12-intel64
-rwxrwxr-x  1 root  admin  152624 Feb  6 23:15 /Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12
-rwxrwxr-x  1 root  admin    2084 Feb  6 23:10 /Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12-config
-rwxrwxr-x  1 root  admin   70544 Feb  6 23:14 /Library/Frameworks/Python.framework/Versions/3.12/bin/python3.12-intel64
➜  ~ which python3
/Library/Frameworks/Python.framework/Versions/3.12/bin/python3
➜  ~ which pip3
/Library/Frameworks/Python.framework/Versions/3.12/bin/pip3
➜  ~

Jupyter启动日志 #

➜  ~ cd desktop
➜  desktop source pythonpro/bin/activate
(PythonPro) ➜  desktop jupyter notebook
[I 2024-03-07 11:06:35.259 ServerApp] jupyter_lsp | extension was successfully linked.
[I 2024-03-07 11:06:35.261 ServerApp] jupyter_server_terminals | extension was successfully linked.
[I 2024-03-07 11:06:35.262 ServerApp] jupyterlab | extension was successfully linked.
[I 2024-03-07 11:06:35.264 ServerApp] notebook | extension was successfully linked.
[I 2024-03-07 11:06:35.480 ServerApp] notebook_shim | extension was successfully linked.
[I 2024-03-07 11:06:35.505 ServerApp] notebook_shim | extension was successfully loaded.
[I 2024-03-07 11:06:35.506 ServerApp] jupyter_lsp | extension was successfully loaded.
[I 2024-03-07 11:06:35.506 ServerApp] jupyter_server_terminals | extension was successfully loaded.
[I 2024-03-07 11:06:35.507 LabApp] JupyterLab extension loaded from /Users/mbpro/Desktop/pythonpro/lib/python3.12/site-packages/jupyterlab
[I 2024-03-07 11:06:35.507 LabApp] JupyterLab application directory is /Users/mbpro/Desktop/pythonpro/share/jupyter/lab
[I 2024-03-07 11:06:35.508 LabApp] Extension Manager is 'pypi'.
[I 2024-03-07 11:06:35.525 ServerApp] jupyterlab | extension was successfully loaded.
[I 2024-03-07 11:06:35.527 ServerApp] notebook | extension was successfully loaded.
[I 2024-03-07 11:06:35.527 ServerApp] Serving notebooks from local directory: /Users/mbpro/Desktop
[I 2024-03-07 11:06:35.527 ServerApp] Jupyter Server 2.12.5 is running at:
[I 2024-03-07 11:06:35.527 ServerApp] http://localhost:8888/tree?token=e51e4f84ed8800dc575c8d586a4093e33eb2036501dcd625
[I 2024-03-07 11:06:35.527 ServerApp]     http://127.0.0.1:8888/tree?token=e51e4f84ed8800dc575c8d586a4093e33eb2036501dcd625
[I 2024-03-07 11:06:35.527 ServerApp] Use Control-C to stop this server and shut down all kernels (twice to skip confirmation).
[C 2024-03-07 11:06:35.530 ServerApp]

    To access the server, open this file in a browser:
        file:///Users/mbpro/Library/Jupyter/runtime/jpserver-2274-open.html
    Or copy and paste one of these URLs:
        http://localhost:8888/tree?token=e51e4f84ed8800dc575c8d586a4093e33eb2036501dcd625
        http://127.0.0.1:8888/tree?token=e51e4f84ed8800dc575c8d586a4093e33eb2036501dcd625
[I 2024-03-07 11:06:35.540 ServerApp] Skipped non-installed server(s): bash-language-server, dockerfile-language-server-nodejs, javascript-typescript-langserver, jedi-language-server, julia-language-server, pyright, python-language-server, python-lsp-server, r-languageserver, sql-language-server, texlab, typescript-language-server, unified-language-server, vscode-css-languageserver-bin, vscode-html-languageserver-bin, vscode-json-languageserver-bin, yaml-language-server

解决方案建议 #

一、修复虚拟环境中Jupyter空白问题 #

• 注册虚拟环境内核：激活pythonpro环境后，运行python -m ipykernel install --user --name=pythonpro，将当前环境的Python内核注册到Jupyter，重启Jupyter尝试。
• 清理Jupyter缓存并重装：关闭Jupyter服务，执行rm -rf ~/.jupyter/删除缓存目录；重新激活环境，运行pip install jupyter notebook ipykernel重装相关包，再启动Jupyter。
• 检查浏览器与目录权限：清空浏览器缓存或用隐私模式打开Jupyter链接；执行ls -ld ~/Desktop确认桌面目录当前用户有读写权限。

二、迁移原Documents目录环境至桌面虚拟环境 #

• 导出原环境依赖：切换到原环境（或全局环境），运行pip freeze > requirements.txt导出已安装包列表，将该文件复制到桌面pythonpro目录下。
• 安装依赖到新环境：激活pythonpro环境，运行pip install -r requirements.txt安装所有原环境的包。
• 迁移Notebook文件：直接将Documents目录下的.ipynb文件复制到桌面，启动虚拟环境中的Jupyter即可访问。

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