VSCode的Jupyter Notebook为何自动加载.env文件环境变量？

问题描述 #

我在使用VSCode的Jupyter Notebook扩展时发现，不需要使用python-dotenv或其他特殊操作，工作目录下的.env文件中的环境变量就会被自动加载。操作步骤如下：

mkdir testing
cd testing
python -m venv env
source env/bin/activate
touch .env

在.env文件中添加：

FOO=bar

之后在Notebook里就能直接获取到这个环境变量。我想知道这个现象的原因，以及这是否是VSCode专属的特性（也就是用其他工具打开该Notebook时不会自动加载环境变量）。我已经在macOS和Windows系统上测试过，表现一致。

解答 #

自动加载的原因 #

VSCode的Jupyter Notebook扩展默认内置了.env文件的自动加载机制，这是官方为简化开发者环境变量配置流程设计的功能。当你在VSCode中启动Notebook内核时，扩展会自动扫描当前工作目录（可根据配置扩展到父目录）下的.env文件，解析其中的键值对并注入到内核运行环境中，实现逻辑和python-dotenv库类似，但无需开发者手动引入依赖或编写加载代码。

是否为VSCode专属特性 #

是的，这确实是VSCode Jupyter扩展独有的特性。其他Notebook工具（比如原生Jupyter Notebook/Lab、PyCharm内置的Notebook功能、Google Colab等）默认没有这个自动加载逻辑。如果在这些工具中想要使用.env文件的环境变量，必须手动通过python-dotenv库加载，例如执行以下代码：

from dotenv import load_dotenv
load_dotenv()  # 加载当前目录下的.env文件

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