dynaconf需显式启用environments=true并设置env_for_dynaconf环境变量才能加载多环境配置,配置合并顺序为default→当前环境段落→当前环境文件,且各环境间隔离,共享配置必须置于[default]段。

dynaconf 怎么加载不同环境的配置文件
Dynaconf 默认只读 .env 和 settings.toml,多环境(比如 development、production)得靠显式指定 ENV_FOR_DYNACONF 环境变量或初始化时传 environments=True。不设这个,它压根不会去找 settings.development.toml 这类文件。
- 必须在创建
Dynaconf实例时启用分层:from dynaconf import Dynaconf<br><br>settings = Dynaconf(<br> environments=True, # 关键开关<br> envvar_prefix="MYAPP",<br> settings_files=["settings.toml", ".secrets.toml"],<br>)
- 环境名默认取自
ENV_FOR_DYNACONF,比如运行时执行ENV_FOR_DYNACONF=production python app.py,它才会加载[production]段落和settings.production.toml - 如果没设环境变量,
settings.current_env返回"default",且不会合并任何环境专属段落
为什么 development 配置里的值没覆盖到 production
因为 dynaconf 的层级合并是「从通用到具体」单向覆盖:default → default + development → default + production,但每个环境彼此隔离。你在 [development] 里改了 DEBUG = true,对 production 环境完全没影响——它只看自己的段落和文件。
- 合并顺序固定:
default段落最先加载,然后是当前环境段落,最后是当前环境专属文件(如settings.production.toml) - 所有环境共享的配置必须放在
[default]段落里,不能只写在[development] - 常见错误:把数据库 URL 写在
[development]里,又没在[default]或[production]中声明,结果 production 启动时报KeyError: 'DATABASE_URL'
settings.toml 里 [default] 和 [development] 的语法差异
TOML 段落名本身不区分大小写,但 dynaconf 要求环境名必须小写且匹配 ENV_FOR_DYNACONF 值。另外,[default] 是唯一能被所有环境继承的基础段;其他段落名必须是合法标识符(不能含空格、连字符等),否则解析失败。
PHP商城系统是国内领先商城系统,网店系统,购物系统,网上商城系统,B2C商城系统产品.同时也是一个商业的PHP开发框架。PHP 商城系统由内容、文章、会员、留言、订单、 财务、广告、短消息、数据库管理、营销推广、内置支付管理、商品配送管理、无限级分类、全站搜索等多个功能模块插件组成。在当今瞬机万变的市场环境中,快速高效的IT解决方案是您业务成功的关键。我们PHP商城系统能为您量身打造完全符合需求
- 错误写法:
[prod-v1]→ 报错Invalid environment name: prod-v1
正确写法:[prod_v1]或[production] -
[default]必须存在,哪怕为空;缺失会导致所有环境加载失败 - 嵌套表(table)支持,但跨环境时只合并一层:
[default]<br>database.host = "localhost"<br><br>[development]<br>database.port = 5432 # ✅ 会合并进 database 字典<br><br>[production]<br>database = {host = "prod-db", port = 5433} # ❌ 会整个替换掉 default.database
用 .env 文件切换环境时为什么不生效
.env 文件默认只用于设置系统环境变量,而 dynaconf 只在初始化前读取 ENV_FOR_DYNACONF。如果你在 settings.toml 初始化之后才用 load_dotenv(),或者把 ENV_FOR_DYNACONF=development 写在 .env 里但没在 Dynaconf(...) 之前加载,那就等于没设。
立即学习“Python免费学习笔记(深入)”;
- 必须确保
.env在Dynaconf构造前被加载:from dynaconf import Dynaconf<br>from dotenv import load_dotenv<br><br>load_dotenv() # 必须在这行之后再初始化 settings<br><br>settings = Dynaconf(environments=True, ...)
- 不要依赖
dynaconf loadCLI 命令自动读.env—— 它只读取配置文件,不处理环境变量注入 - 更稳妥的做法是直接用命令行传参:
ENV_FOR_DYNACONF=staging python app.py,避免 .env 加载时机问题
环境切换不是“自动识别”,而是严格依赖初始化时机和变量注入顺序;哪怕只差一行位置,settings.current_env 就可能还是 "default"。









