Dynaconf 项目快速入门指南：Python配置管理利器

Dynaconf 项目快速入门指南：Python配置管理利器

dynaconf dynaconf/dynaconf: 是一个 Python 配置管理库，可以方便地实现配置的统一管理和发布。该项目提供了一个简单易用的配置管理库，可以方便地实现配置的统一管理和发布，同时支持多种配置格式和部署方式。 项目地址: https://gitcode.com/gh_mirrors/dy/dynaconf

什么是Dynaconf？

Dynaconf 是一个强大的Python配置管理库，专为现代应用程序设计。它遵循12要素应用原则，提供了灵活、安全且易用的配置管理方案，支持多种配置源和环境管理。

核心特性

1. 多格式支持：原生支持TOML、YAML、JSON、INI和Python等多种配置文件格式
2. 环境变量集成：完美支持环境变量覆盖配置，包含.env文件支持
3. 多环境管理：内置开发、测试、生产等多环境配置支持
4. 敏感数据保护：提供专门的秘密管理方案，支持Vault和Redis等后端
5. 框架集成：为Django和Flask提供开箱即用的扩展支持
6. 动态配置：支持运行时配置更新和验证

安装与初始化

安装步骤

pip install dynaconf

项目初始化

在项目根目录执行：

dynaconf init -f toml

这会生成三个关键文件：

• config.py：配置入口文件
• settings.toml：应用配置文件
• .secrets.toml：敏感信息文件（自动加入.gitignore）

基础使用

配置文件示例

settings.toml 内容示例：

key = "基础值"
number = 1234
is_enabled = false

[数据库]
地址 = "localhost"
端口 = 5432

代码中使用配置

from config import settings

print(settings.key)  # 输出: "基础值"
print(settings.数据库.端口)  # 输出: 5432

多环境配置

Dynaconf 支持为不同环境定义不同配置：

[default]
数据库地址 = "localhost"

[development]
数据库地址 = "dev.db.example.com"

[production]
数据库地址 = "prod.db.example.com"

通过环境变量切换环境：

export ENV_FOR_DYNACONF=production

敏感信息管理

.secrets.toml 用于存储敏感数据：

[default]
api_key = "default_key"

[production]
api_key = "prod_secure_key_123"

框架集成

Flask集成示例

from flask import Flask
from dynaconf import FlaskDynaconf

app = Flask(__name__)
FlaskDynaconf(app, settings_files=["settings.toml"])

Django集成示例

在settings.py底部添加：

import dynaconf
settings = dynaconf.DjangoDynaconf(__name__)

环境变量覆盖

任何配置都可以通过环境变量覆盖：

export DYNACONF_DATABASE__PORT=3306  # 使用双下划线表示嵌套

最佳实践

1. 推荐使用TOML格式：结构清晰，支持注释，适合配置
2. 生产环境使用Vault：替代.secrets文件存储敏感信息
3. 合理使用环境分层：区分default/development/production等环境
4. 定期验证配置：使用dynaconf validate命令检查配置有效性

进阶功能

1. 动态模板：支持在配置中使用@format和@jinja模板
2. 自定义加载器：可以扩展支持其他配置源
3. CLI工具：提供init、list、validate等实用命令
4. 类型转换：自动将字符串转换为适当类型（如bool/int/float）

Dynaconf 通过其灵活的设计和丰富的功能，能够满足从简单应用到复杂企业系统的各种配置管理需求，是Python项目中配置管理的现代化解决方案。

dynaconf dynaconf/dynaconf: 是一个 Python 配置管理库，可以方便地实现配置的统一管理和发布。该项目提供了一个简单易用的配置管理库，可以方便地实现配置的统一管理和发布，同时支持多种配置格式和部署方式。 项目地址: https://gitcode.com/gh_mirrors/dy/dynaconf