如何在Python中读取并修改环境变量配置文件（.env）？-Python教程-PHP中文网

推荐用dotenv_values()只读取不污染os.environ：它返回干净字典，支持修改校验；写回需手动处理文件内容，避免破坏格式，且修改后须显式调用load_dotenv(override=true)才能生效。

如何在python中读取并修改环境变量配置文件（.env）？

直接读取 .env 文件内容但不加载到 os.environ

多数场景下，你只是想解析 .env 文件的键值对，而不是立刻影响当前进程的环境变量。这时候别用 python-dotenv 的 load_dotenv()，它默认会调用 os.environ.update()——这可能污染调试环境或干扰其他配置逻辑。

推荐用 dotenv_values() 单独解析：

from dotenv import dotenv_values
<h1>只读取，不修改 os.environ</h1><p>config = dotenv_values(".env")
print(config.get("DATABASE_URL"))  # ✅ 安全获取值
print(os.environ.get("DATABASE_URL"))  # ❌ 仍为 None（除非之前已设置）</p>

dotenv_values() 返回普通 dict，支持直接修改、过滤、校验
若文件不存在或路径错误，返回空 dict，不会抛异常 —— 需主动检查 len(config) == 0
注释行（以 # 开头）和空行自动跳过，但带引号的值（如 PATH="/usr/bin:/bin"）会被正确解析

安全地写回修改后的 .env 内容

Python 标准库不提供 .env 文件写入能力，python-dotenv 也**不支持原生写入**。强行用字符串拼接写入容易破坏格式（比如漏掉换行、覆盖注释、引号嵌套出错）。

最稳妥的做法是：先读取原始文本，再按行替换或追加，最后整体写回：

Python 3.14.2

Python 3.14.2是Python编程语言在2025年12月5日发布的稳定版本，属于3.14系列的第二个维护更新。该版本包含了18项修复，重点解决了多进程、数据类及正则表达式等模块的回归问题，并修复了CVE-2025-12084等安全漏洞。此版本标志着自由线程模式（移除GIL）正式获得官方支持，是Python发展的重要里程碑。

下载

def update_env_file(filepath: str, key: str, value: str):
    lines = []
    found = False
    with open(filepath, "r", encoding="utf-8") as f:
        for line in f:
            if line.strip().startswith(f"{key}="):
                lines.append(f"{key}={value}\n")
                found = True
            else:
                lines.append(line)
    if not found:
        lines.append(f"{key}={value}\n")
    with open(filepath, "w", encoding="utf-8") as f:
        f.writelines(lines)

保留原有空行和注释，避免误删说明性内容
值中含空格或特殊字符时，value 应提前用 shlex.quote() 处理（例如 shlex.quote("a b/c") → '"a b/c"'）
不要用 os.environ 作为数据源写回 —— 它可能混入运行时动态设置的变量，非 .env 原始内容

修改后重新加载到 os.environ 的时机问题

改完 .env 文件内容，不代表 os.environ 自动更新。Python 进程启动后，os.environ 是快照，不会监听文件变化。

若需立即生效，必须显式调用 load_dotenv(override=True) —— override=True 才会覆盖已有键，否则只填充缺失项
多次调用 load_dotenv() 会导致重复追加，尤其在模块级导入时易踩坑；建议只在入口点（如 if __name__ == "__main__":）调用一次
修改 .env 后 reload 并不能刷新已初始化的第三方库（如 SQLAlchemy 引擎），它们通常只在首次读取环境变量时缓存配置

多环境（.env.local、.env.prod）的加载顺序陷阱

load_dotenv() 默认只找 .env。要支持多环境文件，得手动指定路径，且顺序很重要：

# 错误：先加载 .env.prod，再被 .env.local 覆盖（如果存在）
load_dotenv(".env.prod")
load_dotenv(".env.local", override=True)  # ✅ 正确顺序：local 优先
<h1>更稳妥的方式：</h1><p>for env_file in [".env.local", ".env.prod", ".env"]:
if os.path.exists(env_file):
load_dotenv(env_file, override=True)
break</p>