Python包打包后无法读取外部项目.env环境变量问题求助

问题根源在于：当你的Python包安装到外部项目后，load_dotenv()默认会在包自身的安装目录（比如site-packages下的包文件夹）寻找.env文件，而不是用户项目的根目录。系统环境变量是全局生效的，所以能正常读取。

以下是几种可行的解决方法：

方法1：默认加载用户当前工作目录的.env #

修改包内加载环境变量的代码，让load_dotenv指向用户运行脚本时的当前工作目录（通常就是用户项目的根目录）：

import os
from dotenv import load_dotenv

# 加载当前工作目录下的.env，override=False表示系统环境变量优先级更高
load_dotenv(dotenv_path=os.path.join(os.getcwd(), ".env"), override=False)

# 读取配置
API_KEY = os.getenv("API_KEY")

这种方式适合用户在项目根目录下直接运行python main.py的场景，此时os.getcwd()就是项目根目录，能正确找到.env。

方法2：允许用户显式指定.env路径 #

给包提供配置接口，让用户可以手动传入.env文件的路径，灵活性更高：

包内代码示例： #

import os
from dotenv import load_dotenv

def get_api_config(dotenv_path=None):
    # 如果用户指定了路径，加载指定的.env
    if dotenv_path:
        load_dotenv(dotenv_path=dotenv_path, override=False)
    else:
        # 默认尝试加载当前工作目录的.env
        load_dotenv(dotenv_path=os.path.join(os.getcwd(), ".env"), override=False)
    
    return {
        "api_key": os.getenv("API_KEY")
    }

用户在main.py中的使用示例： #

from your_package import get_api_config
import os

# 方式1：自动加载当前工作目录的.env
config = get_api_config()

# 方式2：显式指定项目根目录的.env（适合从任意路径运行脚本的场景）
env_file_path = os.path.join(os.path.dirname(os.path.abspath(__file__)), ".env")
config = get_api_config(dotenv_path=env_file_path)

方法3：让用户在自己的代码中加载.env #

如果不想在包内处理.env加载逻辑，可以把加载步骤交给用户，包只负责读取环境变量：

包内代码： #

import os

API_KEY = os.getenv("API_KEY")

用户在main.py中的代码： #

from dotenv import load_dotenv
import os
from your_package import API_KEY

# 用户自己加载项目根目录的.env
load_dotenv(os.path.join(os.path.dirname(os.path.abspath(__file__)), ".env"))

print(API_KEY)

这种方式把控制权完全交给用户，适合对环境变量配置有自定义需求的场景。

内容的提问来源于stack exchange，提问作者Till Müller