@[toc]
`load_dotenv()` 是 `python-dotenv` 库中的一个函数，用于从 `.env` 文件加载环境变量到当前环境中。以下是详细的用法说明：

## 安装

```bash
pip install python-dotenv
```

## 基本用法

### 1. 最简单的用法
```python
from dotenv import load_dotenv
import os

# 加载 .env 文件中的环境变量
load_dotenv()

# 使用环境变量
database_url = os.getenv("DATABASE_URL")
api_key = os.getenv("API_KEY")
```

### 2. 指定自定义的 .env 文件路径
```python
from dotenv import load_dotenv
import os

# 加载指定路径的 .env 文件
load_dotenv("/path/to/your/.env")

# 或者使用相对路径
load_dotenv(".env.local")
```

## 高级用法

### 3. 使用 `dotenv_path` 参数
```python
from dotenv import load_dotenv
import os

# 明确指定文件路径
load_dotenv(dotenv_path=".env.production")

# 如果文件不存在也不会报错
load_dotenv(dotenv_path=".env.local", verbose=True)
```

### 4. 覆盖已存在的环境变量
```python
from dotenv import load_dotenv

# 默认情况下，已存在的环境变量不会被覆盖
load_dotenv()

# 如果要覆盖已存在的环境变量
load_dotenv(override=True)
```

### 5. 详细模式
```python
from dotenv import load_dotenv

# verbose=True 会在加载时输出信息
load_dotenv(verbose=True)
```

## 实际应用示例

### 项目结构示例
```
my_project/
├── .env
├── config.py
└── main.py
```

### .env 文件内容
```env
# 数据库配置
DATABASE_URL=postgresql://user:password@localhost/dbname
API_KEY=your_api_key_here
DEBUG=True
SECRET_KEY=your_secret_key

# 第三方服务
STRIPE_KEY=sk_test_123456
EMAIL_HOST=smtp.gmail.com
```

### config.py
```python
from dotenv import load_dotenv
import os

# 加载环境变量
load_dotenv()

class Config:
    """应用配置类"""
    DATABASE_URL = os.getenv("DATABASE_URL")
    API_KEY = os.getenv("API_KEY")
    DEBUG = os.getenv("DEBUG", "False").lower() == "true"
    SECRET_KEY = os.getenv("SECRET_KEY")
    STRIPE_KEY = os.getenv("STRIPE_KEY")
    EMAIL_HOST = os.getenv("EMAIL_HOST")
    
    # 带默认值的配置
    PORT = int(os.getenv("PORT", "5000"))
```

### main.py
```python
from dotenv import load_dotenv
from config import Config
import os

# 确保环境变量已加载
load_dotenv()

def main():
    # 直接使用 os.getenv
    api_key = os.getenv("API_KEY")
    print(f"API Key: {api_key}")
    
    # 或者使用配置类
    config = Config()
    print(f"Database URL: {config.DATABASE_URL}")
    print(f"Debug mode: {config.DEBUG}")

if __name__ == "__main__":
    main()
```

## 最佳实践

### 1. 创建不同的环境文件
```
.env          # 默认，包含通用配置
.env.local    # 本地开发环境（不提交到版本控制）
.env.production  # 生产环境
.env.staging     # 预发布环境
```

### 2. 在应用启动时加载
```python
from dotenv import load_dotenv
import os

def create_app():
    # 根据环境加载不同的配置文件
    env = os.getenv("FLASK_ENV", "development")
    
    if env == "production":
        load_dotenv(".env.production")
    elif env == "staging":
        load_dotenv(".env.staging")
    else:
        load_dotenv(".env.local")
    
    # 应用初始化代码...
```

### 3. 安全注意事项
- 永远不要将 `.env` 文件提交到版本控制
- 在 `.gitignore` 中添加：
  ```
  .env
  .env.local
  ```
- 使用 `.env.example` 文件来记录需要的环境变量

## 错误处理

```python
from dotenv import load_dotenv, dotenv_values
import os

try:
    load_dotenv()
except Exception as e:
    print(f"加载环境变量失败: {e}")

# 或者只读取值而不设置环境变量
config = dotenv_values(".env")
database_url = config.get("DATABASE_URL")
```

`load_dotenv()` 是一个简单但强大的工具，可以帮助你更好地管理应用配置，特别是在不同环境间切换时非常有用。

@[toc]load_dotenv() 是 python-dotenv 库中的一个函数，用于从 .env 文件加载环境变量到当前环境中。以下是详细的用法说明：

[1343]python-dotenv库用法

编程语言

Python-dotenv库的load_dotenv()函数用于从.env文件加载环境变量，支持自定义路径、覆盖变量和详细模式。通过合理配置不同环境文件(.env.local/.env.production)管理敏感信息，提升项目安全性。适用于数据库连接、API密钥等配置管理，是Python项目环境变量管理的标准解决方案。

2026新春采购季

tencentdb-catalog

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Python-dotenv库的load_dotenv()函数用于从.env文件加载环境变量，支持自定义路径、覆盖变量和详细模式。通过合理配置不同环境文件(.env.local/.env.production)管理敏感信息，提升项目安全性。适用于数据库连接、API密钥等配置管理，是Python项目环境变量管理的标准解决方...

[1343]python-dotenv库用法-腾讯云开发者社区-腾讯云

[1343]python-dotenv库用法

[1343]python-dotenv库用法

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐