诸神缄默不语-个人CSDN博文目录
在开发过程中，经常需要使用到各种配置信息，如数据库连接字符串、API 密钥等。为了保证这些信息的安全性，以及提高代码的可维护性和灵活性，我们通常会将这些敏感信息存储在环境变量中，而不是直接硬编码在源代码里。本文将介绍如何使用 python-dotenv 包来管理这些环境变量，确保你的 Python 项目更加安全和灵活。
python-dotenv官方pip网站：python-dotenv · PyPI
文章目录
- 为什么要使用 .env 文件储存系统变量
- 安全性
- 便于管理
- 灵活性
- 使用 python-dotenv 管理环境变量
- 安装 python-dotenv
- 创建和配置 .env 文件
- 在 Python 中加载和使用环境变量
- 结语
为什么要使用 .env 文件储存系统变量
安全性
将敏感信息如 API 密钥、数据库密码等存放在 .env 文件中可以有效地避免这些信息被提交到版本控制系统（如 Git）中，减少敏感信息泄露的风险。
有助于遵循最佳实践，即不在源代码中硬编码敏感信息。
便于管理
通过使用 .env 文件，所有的配置信息都集中在一个地方，方便管理和更新。特别是在项目需要在多种环境（开发、测试、生产等）运行时，可以通过更换不同的 .env 文件来快速切换环境配置。
灵活性
环境变量的使用提高了项目的灵活性，允许同一份代码在不同的环境下运行而无需修改代码本身。这在多人协作和应用部署时尤为重要。
使用 python-dotenv 管理环境变量
python-dotenv 是一个 Python 库，可以用来读取 .env 文件中的环境变量，并将它们加载到 Python 的环境变量中。这使得在代码中使用这些变量变得非常简单和直接。
安装 python-dotenv
首先，你需要安装 python-dotenv。可以通过 pip 命令轻松安装：
pip install python-dotenv
创建和配置 .env 文件
在项目的根目录下创建一个名为 .env 的文件。在这个文件中，你可以定义需要的环境变量，例如：
# 这是 .env 文件中的注释
DATABASE_URL="mysql://username:password@localhost/dbname"
API_KEY="your-secret-api-key"
请注意，.env 文件支持 # 开头的注释。
在 Python 中加载和使用环境变量
接下来，你可以在 Python 代码中使用 python-dotenv 来加载这些环境变量。一种常见的做法是在项目的入口文件（如 app.py 或 main.py）中加载这些变量：
from dotenv import load_dotenv
import os
# 加载 .env 文件
load_dotenv()
# 使用环境变量
database_url = os.getenv('DATABASE_URL')
api_key = os.getenv('API_KEY')
print("Database URL:", database_url)
print("API Key:", api_key)
这段代码首先从 .env 文件加载环境变量，然后通过 os.getenv 方法访问这些变量。
结语
通过使用 python-dotenv 和 .env 文件来管理环境变量，你的 Python 项目将更加安全、易于管理和灵活。这种方法尤其适合处理敏感信息和支持多环境配置，是现代应用开发的一种最佳实践。
