顶层作用域中不能直接使用 yield，因为 Python 解释器硬性禁止 top-level yield，会触发 SyntaxError；yield 必须位于函数体内以构建生成器对象。
顶层作用域中不能直接使用 yield —— 这不是语法限制的“优雅与否”问题，而是 Python 解释器的硬性规则：top-level yield 会导致 SyntaxError。任何未包裹在函数定义内的 yield 表达式（包括模块级、类体外、if 块顶层等）都会被拒绝编译。
为什么“Top-level yield”根本不可行
Python 的生成器机制依赖于函数调用上下文：只有当解释器进入一个被标记为 generator function（即含 yield 的 def）时，才会构建生成器对象并挂起执行。模块加载过程是线性执行的脚本流程，没有“暂停-恢复”语义支撑，因此：
-
yield只能出现在def函数体内，且该函数调用后返回 generator 对象 - 试图在
.py文件最外层写yield {...}，会立即报错：SyntaxError: 'yield' outside function - 即便借助
exec()或 AST 重写强行注入，也无法绕过编译期校验，属于未定义行为
真正可行的“动态+敏感+环境隔离”配置流方案
你想要的效果——按需加载、环境区分、敏感字段不落地、内存可控——完全可达成，但需放弃“顶层 yield”这个伪需求，转而采用已被生产验证的组合模式：
-
用 PydanticSettings + dotenv 实现环境感知加载：通过
ENVIRONMENT=prod python app.py自动加载.env.prod，敏感字段默认不进日志，类型自动校验 -
敏感值走 KMS 懒解密：配置模型中字段声明为
SecretStr或自定义@computed_field，首次访问时才调用boto3.client('kms').decrypt()，解密结果缓存在contextvars.ContextVar中，生命周期绑定请求上下文 -
热更新靠显式 reload() 方法：封装一个
ConfigManager单例，内部持有一个BaseSettings实例；外部通过 HTTP endpoint（如POST /config/reload）或信号（SIGHUP）触发.reload()，重新实例化 settings 并校验，全程无轮询、无竞态
一个轻量可运行的防腐配置流示例
以下代码片段展示如何在不暴露明文、不硬编码、不重启进程的前提下，让配置像“流”一样按需供给业务逻辑：
from pydantic_settings import BaseSettings
from pydantic import SecretStr, computed_field
from contextvars import ContextVar
import os
<h1>当前请求上下文中的解密密钥缓存</h1><p>_decrypted_key_var = ContextVar("decrypted_api_key", default=None)</p><p>class AppConfig(BaseSettings):
ENVIRONMENT: str = "dev"
DB_HOST: str
API_KEY_ENCRYPTED: str # KMS 加密后的 base64 字符串</p><pre class="brush:php;toolbar:false;">@computed_field
@property
def API_KEY(self) -> SecretStr:
key = _decrypted_key_var.get()
if key is None:
# 此处调用 KMS decrypt，仅首次访问触发
key = self._decrypt_kms(self.API_KEY_ENCRYPTED)
_decrypted_key_var.set(key)
return SecretStr(key)
def _decrypt_kms(self, cipher: str) -> str:
# 真实场景调用 boto3 / google.cloud.secretmanager...
return "live-decrypted-key-from-kms" # 演示占位全局单例，支持 .reload()
config = AppConfig()
业务中安全使用（.get_secret_value() 才暴露明文）
def send_request(): headers = {"Authorization": f"Bearer {config.API_KEY.get_secret_value()}"} ...
这种结构把“动态”落在 reload 触发时机，“防腐”落在字段掩码与 KMS 隔离，“流式”体现在按需解密与上下文绑定——比强行塞 yield 到顶层更稳健、更可观测、更易审计。
