Jupyter Notebook无法读取环境变量，但终端printenv可见的问题排查

核心原因 #

你手动执行source ./activate是在当前bash会话中加载环境变量，但Jupyter（无论是Web界面还是VS Code远程启动的实例）是作为独立进程启动的，它不会自动继承你手动激活的虚拟环境会话中的变量，除非你配置Jupyter启动时明确加载该环境。

具体场景拆解 #

• 终端启动Python能读取变量：因为Python进程是在已经执行过source ./activate的bash会话中启动的，直接继承了当前shell的环境变量。
• Jupyter无法读取变量：
  • Web界面启动的Jupyter：通常由系统服务、桌面快捷方式或后台进程启动，这些启动路径不会执行你的source ./activate命令，自然无法获取对应变量。
  • VS Code远程连接的Jupyter：VS Code会创建独立进程启动Jupyter内核，默认不会关联你手动在终端激活的环境会话，未加载对应变量。

解决办法 #

方法1：将变量写入Jupyter配置文件 #

1. 生成Jupyter配置文件（未生成过的话执行）：

   jupyter notebook --generate-config
   

2. 打开配置文件（默认路径为~/.jupyter/jupyter_notebook_config.py），添加如下内容：

   import os
   # 先继承系统环境变量，再追加自定义变量
   c.NotebookApp.env = os.environ.copy()
   c.NotebookApp.env['MYVAR'] = 'blahblah'
   

   若仅需添加单个变量，也可直接写：

   c.NotebookApp.env = {'MYVAR': 'blahblah'}
   

方法2：配置Jupyter内核加载虚拟环境脚本 #

1. 找到虚拟环境对应的Jupyter内核配置文件，路径通常为~/.local/share/jupyter/kernels/[你的虚拟环境名称]/kernel.json
2. 修改argv字段，让内核启动前先加载activate脚本：

   {
    "argv": [
     "/bin/bash",
     "-c",
     "source /path/to/your/activate && python -m ipykernel_launcher -f {connection_file}"
    ],
    "display_name": "YourEnvName",
    "language": "python"
   }
   

   注意替换/path/to/your/activate为你实际的activate脚本路径。

方法3：将变量写入全局环境配置文件 #

若该变量无需局限于虚拟环境，可将export MYVAR=blahblah写入~/.bashrc或~/.profile文件，这样所有以你的用户身份启动的进程都会加载该变量。但不建议虚拟环境专属变量使用此方法，避免污染全局环境。

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