当前位置：首页 > news >正文

Python dotenv 使用指南：轻松管理项目环境变量

news 来源：原创 2025/6/18 18:03:47

在这里插入图片描述

一、为什么要使用环境变量管理？

很多开发者容易把自己开发的项目上传到Github上，但偶尔会忘记把数据库密码、支付接口密钥等敏感信息和谐掉，当代码提交上去时，这些信息就像裸奔一样暴露在所有人面前。更糟糕的是，不同环境（开发 / 测试 / 生产）的配置频繁切换，每次都要修改代码，效率低下且容易出错。

环境变量管理的核心价值在于：

安全隔离：敏感信息不进代码库，通过.env 文件独立存储
环境统一：开发 / 测试 / 生产环境配置一键切换
协作友好：团队成员共享配置模板（.env.example），各自维护敏感信息
12-Factor 合规：符合现代云原生应用的最佳实践

二、Python dotenv 核心功能速览

python-dotenv 是 Python 生态中管理环境变量的瑞士军刀，它能：

自动加载：从.env 文件读取配置并注入环境变量
类型安全：支持布尔值、数字等类型自动转换
多环境管理：通过不同的.env 文件适配开发 / 生产环境
框架集成：与 Flask、Django、FastAPI 等主流框架无缝协作

三、5 分钟快速上手

1. 安装与初始化

# 基础安装
pip install python-dotenv
# 推荐安装带CLI工具的版本
pip install "python-dotenv[cli]"

2. 创建配置文件

在项目根目录创建.env 文件：

# 数据库配置
DB_HOST=localhost
DB_PORT=5432
DB_USER=admin
DB_PASS=s3cr3t!   # 包含特殊字符无需引号# 功能开关
FEATURE_NEW_LOGIN=true
API_RATE_LIMIT=100

3. 加载与使用

# app.py
from dotenv import load_dotenv
import os# 自动搜索并加载.env文件
load_dotenv(verbose=True, override=True)# 读取配置的三种方式
db_host = os.getenv('DB_HOST')  # 带默认值
db_port = os.getenv('DB_PORT', 5432)  # 带默认值
db_user = os.environ['DB_USER']  # 直接访问，不存在会抛异常print(f"Connecting to {db_user}@{db_host}:{db_port}")

四、生产级实践方案

1. 多环境配置管理

# 目录结构
config/
├── .env.local      # 本地开发环境
├── .env.staging    # 预发布环境
├── .env.production # 生产环境
└── .env.example    # 配置模板（需提交到代码库）

# 根据环境变量加载不同配置
import os
from dotenv import load_dotenvenv = os.getenv('ENV', 'local')
load_dotenv(f'config/.env.{env}')

2. 类型安全与验证

from pydantic import BaseSettingsclass Settings(BaseSettings):api_key: strdebug: bool = Falserate_limit: int = 100class Config:env_file = ".env"settings = Settings()

3. 安全增强方案

① 加密敏感信息

# 使用ansible-vault加密.env文件
ansible-vault encrypt .env.production

② 云原生存储

# 结合AWS Parameter Store
import boto3
from dotenv import dotenv_valuesdef load_aws_secrets():client = boto3.client('ssm')response = client.get_parameter(Name='/prod/database/password',WithDecryption=True)return {'DB_PASS': response['Parameter']['Value']}config = {**dotenv_values('.env.production'),**load_aws_secrets()
}

五、常见问题与解决方案

1. 变量未生效？

# 强制覆盖现有环境变量
load_dotenv(override=True)# 检查文件路径
load_dotenv('/custom/path/.env')

2. Flask 项目无法启动？

# 避免在项目根目录创建.env文件
project/
├── app/
│   ├── __init__.py
│   └── .env       # 正确位置
└── .env           # 错误位置

3. Docker 部署问题

# 最佳实践：使用构建参数传递敏感信息
FROM python:3.9ARG DB_PASS
ENV DB_PASS=${DB_PASS}COPY requirements.txt .
RUN pip install -r requirements.txtCOPY . .
CMD ["python", "app.py"]

# 构建时传递参数
docker build --build-arg DB_PASS=my_secret -t myapp .

六、框架集成实战

1. Flask 自动加载

# 创建.flaskenv文件
FLASK_DEBUG=1
FLASK_ENV=development

# 自动生效，无需额外代码
from flask import Flask
app = Flask(__name__)
app.config['SQLALCHEMY_DATABASE_URI'] = os.getenv('DATABASE_URL')

2. Django 配置优化

# settings.py
from dotenv import load_dotenv
load_dotenv()SECRET_KEY = os.getenv('SECRET_KEY')
DATABASES = {'default': {'ENGINE': 'django.db.backends.postgresql','NAME': os.getenv('DB_NAME'),'USER': os.getenv('DB_USER'),'PASSWORD': os.getenv('DB_PASS'),}
}

3. FastAPI 类型验证

from fastapi import FastAPI
from pydantic import BaseSettingsclass Settings(BaseSettings):api_key: strdebug: bool = Falseclass Config:env_file = ".env"settings = Settings()
app = FastAPI()@app.get("/")
async def root():return {"message": "Hello World", "debug": settings.debug}

七、性能优化技巧

1. Serverless 预加载

# AWS Lambda 冷启动优化
import os
from dotenv import load_dotenv# 初始化阶段加载
load_dotenv()def lambda_handler(event, context):return {"db_pass": os.getenv('DB_PASS')}

2. 缓存加速

from redis import Redis
from dotenv import load_dotenvload_dotenv()
redis = Redis(host=os.getenv('REDIS_HOST'))# 缓存敏感信息
def get_secret(key):value = redis.get(key)if not value:value = os.getenv(key)redis.set(key, value, ex=3600)return value

八、扩展应用场景

1. Jupyter Notebook 魔法指令

%load_ext dotenv
%dotenv  # 自动加载.env文件

2. 命令行工具

# 直接执行命令
dotenv -f .env.prod run python manage.py migrate

3. 自动化测试

# conftest.py
import pytest@pytest.fixture(scope='session', autouse=True)
def load_test_env():from dotenv import load_dotenvload_dotenv('.env.test')

完整代码示例

# app.py
from dotenv import load_dotenv
import os# 加载配置
load_dotenv(verbose=True, override=True)# 读取配置
config = {'db_host': os.getenv('DB_HOST'),'db_port': int(os.getenv('DB_PORT', 5432)),'db_user': os.environ['DB_USER'],'db_pass': os.getenv('DB_PASS'),'debug': os.getenv('DEBUG', 'False').lower() == 'true'
}print("Configuration loaded:")
for key, value in config.items():print(f"{key}: {value}")

参考

官方文档
Github
12-Factor 应用规范
Python 配置管理进阶

Python dotenv 使用指南：轻松管理项目环境变量

一、为什么要使用环境变量管理？ 很多开发者容易把自己开发的项目上传到Github上，但偶尔会忘记把数据库密码、支付接口密钥等敏感信息和谐掉，当代码提交上去时，这些信息就像裸奔一样暴露在所有人面前。更糟糕的是，不同…...

编程日记 2025/5/30 4:19:06

网络攻防第一~四集

来源于一下【小迪安全】红蓝对抗 | 网络攻防 | V2023全栈培训_哔哩哔哩_bilibili 目录第一集第二集第一集 web架构包括系统、中间件、程序源码、数据库系统 windows、linux、windows server 中间件是前端语言和数据库是当做一个桥梁，当做解析作用&…...

编程日记 2025/6/3 10:11:42

TI---sysconfig生成宏

核心内容概览 1. 宏定义的总体作用 SysConfig生成的宏定义是硬件配置的符号化映射，将图形化界面的配置参数转化为可直接引用的编译时常量，核心价值包括： 免硬编码：避免手动写入硬件参数（如引脚号、波特率&#xff0…...

编程日记 2025/5/29 15:24:39

【C】初阶数据结构13 -- 快速排序

本篇文章主要讲解经典的排序算法 -- 快速排序算法目录 1 递归版本的快速排序 1） 算法思想 （1） hoare 版本 （2） 双指针版本 （3） 挖坑法 2） 代码 3） 时间复杂度…...

编程日记 2025/5/31 13:44:35

Spring Boot 3.4 实战指南：从性能优化到云原生增强

一、核心新特性概览 Spring Boot 3.4 于 2024 年 11 月正式发布，带来 6 大维度的 28 项改进。以下是实战开发中最具价值的特性： 1. 性能革命：虚拟线程与 HTTP 客户端优化虚拟线程支持：Java 21 引入的虚拟线程在 Spring Boot 3…...

编程日记 2025/6/4 8:19:42

Git分支重命名与推送参数解析

这两个参数的解释如下： git branch -M master 中的 -M 参数 -M 是 --move --force 的组合简写，表示强制重命名当前分支为 master。如果当前分支已经存在名为 master 的分支，-M 会强制覆盖它（慎用，可能导致数据丢失&…...

编程日记 2025/6/2 21:34:53

深度学习中的预训练与微调：从基础概念到实战应用全解析

摘要本文系统解析深度学习中预训练与微调技术，涵盖核心概念、技术优势、模型复用策略、与迁移学习的结合方式，以及微调过程中网络参数更新机制、模型状态分类等内容。同时深入分析深层神经网络训练难点如梯度消失/爆炸问题，为模型优化提供理…...

编程日记 2025/6/2 2:23:46

EMC-148.5MHz或85.5辐射超标-HDMI

EMC 148.5MHz或85.5辐射超标-HDMI 遇到了一台设备过不了EMC ，经排查主要是显示器的HDMI问题解决办法看看能否更换好一点的HDMI线缆...

编程日记 2025/5/27 8:36:51

DeepSeek系列（9）：团队协作最佳实践

团队知识库构建在知识经济时代，团队知识的有效管理和传递是组织核心竞争力的关键。DeepSeek可以成为打造高效团队知识库的得力助手，让知识管理从繁重工作变为自动化流程。知识库架构设计多层次知识结构一个高效的团队知识库应具备清晰的层级结构，DeepSeek可以协助：…...

编程日记 2025/5/29 23:49:21

信息系统项目管理工程师备考计算类真题讲解十

一、立项管理 1）折现率和折现系数：折现也叫贴现，就是把将来某个时间点的金额换算成现在时间点的等值金额。折现时所使用的利率叫折现率，也叫贴现率。若n年后能收F元，那么这些钱在现在的价值，就是现值&am…...

编程日记 2025/5/25 10:23:58

第1章基础知识

1.1 机器语言 1.2 汇编语言的产生用汇编语言编写程序的工作过程如下： 1.编写程序：汇编程序包括汇编指令、伪指令、其他符号，如下图。其中，“伪指令”并不是由计算机直接执行的指令，而是帮助编译器完成“编译”的符号。 2.编译：将汇编程序转换成机器码。 3.计算机执行。 …...

编程日记 2025/5/29 13:54:07

16.【.NET 8 实战--孢子记账--从单体到微服务--转向微服务】--微服务基础工具与技术--Github Action

GitHub Actions 是 GitHub 提供的持续集成和持续部署(CI/CD)平台，它允许我们自动化软件开发工作流程。通过 GitHub Actions，我们可以构建、测试和部署代码，而无需手动干预。一、基本概念 1.1 Workflow（工作流） 工作…...

编程日记 2025/6/3 8:51:25

‌MySQL 事务隔离级别详解

‌ 以下是 MySQL 支持的四种事务隔离级别及其特性，按并发安全性从低到高排列： ‌1. 读未提交 (Read Uncommitted)‌ ‌问题‌： ‌脏读 (Dirty Read)‌：事务可读取其他事务未提交的数据。‌不可重复读 (Non-repeatable Read)‌&am…...

编程日记 2025/5/31 14:21:49

time limit per test 1 second memory limit per test 256 megabytes Chaneka, Pak Chaneks child, is an ambitious kid, so Pak Chanek gives her the following problem to test her ambition. Given an array of integers [A1,A2,A3,…,AN][A1,A2,A3,…,AN]. In one o…...

编程日记 2025/6/4 10:51:06

C19-while循环及for循环等价引入

一 while的表达式 //while的表达式有三个 #include <stdio.h> int main() { int sum; int data1; //第一个表达式,条件的初始值while(data<100){ //第二个表达式,条件的临界值sumsumdata;data; //第三个表达式,条件变化}printf("0至100的和是:%d\n",sum);…...

编程日记 2025/5/29 22:39:38

华为盘古OS深度评测：构建AI自进化系统的实践密码

华为盘古OS通过分布式AI内核与自适应学习框架的深度耦合，重新定义操作系统级智能能力。实测显示其AI任务调度效率较传统系统提升17倍，本文从智能体编排、持续学习机制、端云协同架构三个维度，解析如何基于DevKit 3.0打造具备认知进化能力的下…...

编程日记 2025/6/3 2:12:16

SpringBoot UserAgentUtils获取用户浏览器操作系统设备统计信息统计日志入库

介绍 UserAgentUtils 是于处理用户代理（User-Agent）字符串的工具类，一般用于解析和处理浏览器、操作系统以及设备等相关信息，这些信息通常包含在接口请求的 User-Agent 字符串中。这个库可以用于解析用户代理头，以提…...

编程日记 2025/6/1 17:03:26

PCL绘制点云+法线

读取的点云ASCII码文件，每行6个数据，3维坐标3维法向 #include <iostream> #include <fstream> #include <vector> #include <string> #include <pcl/point_types.h> #include <pcl/point_cloud.h> #include <pc…...

编程日记 2025/5/30 5:06:05

DataStreamAPI实践原理——计算模型

引入 Apache Flink 是一个框架和分布式处理引擎，用于在无边界和有边界数据流上进行有状态的计算。Flink 能在所有常见集群环境中运行，并能以内存速度和任意规模进行计算。Flink可以处理批数据也可以处理流数据，本质上，流处理…...

编程日记 2025/6/2 7:34:30

【那些年踩过的坑】Docker换源加速详细教程（截至2025年4月）

由于各种网络政策，在国内访问DockerHub速度会非常缓慢，大家一般都会采取更换镜像源的方式来进行加速。但是，2024.6之后，由于政策的加强，大部分常见的镜像源已经无法使用，可能在更换镜像源后出现如下报错信息…...

编程日记 2025/6/1 13:53:38

【MCP】详细了解MCP协议：和function call的区别何在？如何使用MCP？

本文介绍了MCP大模型上下文协议的的概念，并对比了MCP协议和function call的区别，同时用python sdk为例介绍了mcp的使用方式。 1. 什么是MCP？ 官网：https://modelcontextprotocol.io/introduction 2025年，Anthropic提出…...

编程日记 2025/6/1 9:03:13

交换机之配置系统基本信息（Basic Information of the Configuration System for Switches）

交换机之配置系统基本信息本文章中的信息都是基于一些特定实验环境写的。文章中使用的所有设备最初均采用缺省配置启动。如果不按初始配置，有可能会导致本文中的部分或全部步骤失败。如果您使用的是真实网络设备，请确保您已经了解所有使用过的命令影响。…...

编程日记 2025/6/1 10:25:12

贝叶斯算法学习

贝叶斯算法学习贝叶斯算法基础与原理应用场景主要分类优缺点简单示例代码实现贝叶斯算法是基于贝叶斯定理的一种统计学习方法，在机器学习、数据挖掘、自然语言处理等领域有广泛应用。以下是其原理、应用和示例的详细介绍： 贝叶斯算法基础与原理贝…...

编程日记 2025/5/24 8:08:37

Java 日志：掌握本地与网络日志技术

日志记录是软件开发中不可或缺的一部分，它为开发者提供了洞察应用程序行为、诊断问题和监控性能的手段。在 Java 生态系统中，日志框架如 Java Util Logging (JUL)、Log4j 和 Simple Logging Facade for Java (SLF4J) 提供了丰富的功能。然而，…...

编程日记 2025/6/1 2:20:43

线程池单例模式

线程池的概念线程池是一种线程使用模式。一种线程使用模式。线程过多会带来调度开销，进而影响缓存局部性和整体性能。而线程池维护着多个线程，等待着监督管理者分配可并发执行的任务。…...

编程日记 2025/6/4 7:46:15

物联网安全解决方案介绍：有效利用现有的下一代防火墙

管理物联网设备安全的挑战如今，随着IoT（物联网）的普及，可以集中管理相机、打印机、传感器、电器、机床等各种设备，并分析和有效利用从这些设备收集的数据。这些设备已成为商业环境中不可或缺的一部分，但设备的多样化使其难以管理。与PC、服务器和网络设备不同，识别物联…...

编程日记 2025/6/3 4:58:07

Java社区门诊系统源码 SaaS医院门诊系统源码可上线运营

Java社区门诊系统源码 SaaS医院门诊系统源码医院门诊系统适用于：社区卫生服务站、门诊部、诊所、村卫生室等，有上百家医疗机构正常使用；包括医保结算。系统功能 （一）后端管理系统功能用户管理：提供用…...

编程日记 2025/6/1 19:54:45

如何在 Windows 10 中使用 WSL 和 Debian 安装 Postgresql 和 Postgis

安装 Postgresql 和 Postgis 的常规方法需要设置多个二进制文件，并且工作流程通常在图形用户界面 (GUI) 上进行。我们希望找到一种在 Windows 10 中安装 Postgresql 和 Postgis 的方法，同时保留 Linux 的 shell 体验。本教程展示了在 Windows 10 中的 De…...

编程日记 2025/6/1 15:27:54

[论文解析]Mip-Splatting: Alias-free 3D Gaussian Splatting

Mip-Splatting: Alias-free 3D Gaussian Splatting 论文地址：https://arxiv.org/abs/2403.17888 源码地址：https://github.com/autonomousvision/mip-splatting 项目地址：https://niujinshuchong.github.io/mip-splatting/ 论文解读两个主…...

编程日记 2025/5/29 10:18:11

MongoDB 入门使用教程

MongoDB 入门使用教程 MongoDB 是一个开源的 NoSQL 数据库，使用文档（JSON-like）存储数据，与传统的关系型数据库不同，它不依赖表结构和行列的约束。MongoDB 提供了强大的查询能力，支持高效的数据存储和检索…...

编程日记 2025/6/3 12:23:38

PowerBI动态路径获取数据技巧

PowerBI动态路径获取数据技巧场景一：同事接力赛——不同电脑共用模板 （想象一下：小王做完报表要传给小李，结果路径总对不上怎么办？） 这种情况就像接力赛交接棒，每台电脑的账户名不同&#xff0…...

编程日记 2025/5/29 17:42:17

【数据结构】优先级队列

目录 1. 优先级队列概念 2. 优先级队列的模拟实现 2.1 堆的概念 2.2 堆的存储方式 2.3 堆的创建 2.3.1 向下调整的时间复杂度 2.3.2 建堆时间复杂度 2.3.3 向上调整的时间复杂度 2.4 堆的插入与删除 3. 堆的应用 4. 常用接口介绍 4.1 PriorityQueue的特性 4.2 Pri…...

编程日记 2025/5/29 10:16:04

Myweb项目——面试题总结

一.项目描述项⽬概述：本项⽬在云服务上开发了⼀个后端服务器与前端⻚⾯为⼀体的⾳乐专辑鉴赏⽹站，旨在为⽤⼾提供丰富的⾳乐专辑信息展⽰和优质的浏览体验。主要内容及技术： 后端开发：利⽤ C 语⾔构建后端服务器，…...

编程日记 2025/6/3 17:50:08

用高德API提取广州地铁线路（shp、excel）

目录结果示例html文件——直观看出输出的效果excel文件——包括地铁的具体信息完整代码网络上现有的地铁数据要么过于老旧且不便于更新，要么过于定制化限定于具体的城市无法灵活调整得到自己真正想要的那部份数据。而使用高德的API可以非常方便得到全国各地的地铁数据，而且可…...

编程日记 2025/6/3 2:27:51

leetcode110 平衡二叉树

一棵高度平衡二叉树定义为：一个二叉树每个节点的左右两个子树的高度差的绝对值不超过1。二叉树节点的深度：指从根节点到该节点的最长简单路径边的条数。二叉树节点的高度：指从该节点到叶子节点的最长简单路径边的条数。递归：…...

编程日记 2025/6/3 20:26:46

二、信息时代社会结构的转变

到了信息时代,以及在核武器的前提下,上述的社会结构的逻辑,就有了一个根本性的转变,就是暴力的成本和收益,都在下降。暴力的成本在降低。比如说枪支,它的制造和分发都变得非常容易。现在我们都知道有 3D 打印,它就好像工业时代的印刷机,印刷圣经或者书籍,使知识更加普及和容…...

编程日记 2025/6/1 17:17:27

Vue2+ElementUI实现无限级菜单

使用Vue2和ElementUI实现无限级菜单，通常菜单数据以树形结构存储，每个菜单包含多个子菜单，子菜单又可以继续包含更深层次的子菜单项。所以，需要使用递归形式，完成子项菜单的渲染。这里，结合Element UI界面的el-menu和el-submenu组件来构建菜单结构，有子菜单时使用el-s…...

编程日记 2025/6/1 18:07:35

YTJ笔记——FFT、NCC

FFT算法快速傅里叶算法为了计算两个多项式相乘（卷积），将多项式系数表示法转换成点值表示法 F(g(x)∗f(x))F(g(x))F(f(x)） 超详细易懂FFT（快速傅里叶变换）及代码实现_傅立叶变换编程-CSDN博客 NCC算法…...

编程日记 2025/6/3 19:14:24

模型隐含前提

系列文章分享模型，了解更多👉 模型_思维模型目录。隐藏的思维地基，决策的无声推手。 1 隐含前提模型的应用 1.1 金融投资决策—科技股估值隐含前提的验证行业：金融投资应用方向：投资逻辑验证背景解读&#xff1…...

编程日记 2025/5/30 9:04:34

大模型微调与蒸馏的差异性与相似性分析

大模型微调与蒸馏的差异性分析一、定义与核心目标差异大模型微调在预训练大模型基础上，通过少量标注数据调整参数，使模型适应特定任务需求。核心目标是提升模型在特定领域的性能，例如医疗影像分析或金融预测。该技术聚焦于垂直场景的精度…...

编程日记 2025/6/2 0:34:59

Ubuntu下安装vsode+qt搭建开发框架(一)

Ubuntu下安装vsode+qt搭建开发框架(一) g++的编译环境，这里不介绍，可点击这里查看查看一下当前的g++环境 g++ --version g++ (Ubuntu 11.4.0-1ubuntu1~22.04) 11.4.0 Copyright (C) 2021 Free Software Foundation, Inc. This is free software; see the source for copyin…...

编程日记 2025/6/1 9:24:54

单片机-89C51部分：3、创建工程

飞书文档https://x509p6c8to.feishu.cn/wiki/Mzhnwb1qni6YkykJtqXc17XMnre 创建工程首先创建一个文件夹，用来存放工程文件，文件夹名称最好为英文，例如Demo1。打开软件KEIL，上方菜单栏选择Project ->new uVision Project&am…...

编程日记 2025/6/2 1:57:54

从零实现 registry.k8s.io/pause:3.8 镜像的导出与导入

以下是为 registry.k8s.io/pause:3.8 镜像的导出与导入操作定制的完整教程，适用于 Kubernetes 集群中使用 containerd 作为容器运行时的场景。本教程包含详细步骤、常见问题解析及注意事项。从零实现 registry.k8s.io/pause:3.8 镜像的导出与导入背景说明 Kuber…...

编程日记 2025/5/29 21:34:28

详解Adobe Photoshop 2024 下载与安装教程

Adobe Photoshop下载安装和使用教程 Adobe Photoshop，简称“PS”，是由Adobe Systems开发和发行的图像处理软件。Photoshop主要处理以像素所构成的数字图像。使用其众多的编修与绘图工具，可以有效地进行图片编辑和创造工作&#xff0c…...

编程日记 2025/6/4 15:48:22

thinking-intervention开源程序用于DeepSeek-R1等推理模型的思维过程干预，有效控制推理思考过程

一、软件介绍文末提供程序和源码下载 thinking-intervention开源程序用于DeepSeek-R1等推理模型的思维过程干预，有效控制推理思考过程。基于论文《Effectively Controlling Reasoning Models through Thinking Intervention》实现的思维干预技术，用于…...

编程日记 2025/6/2 23:39:37