用途：把环境相关配置从代码中外部化，用环境变量驱动同一份代码在不同环境运行；在启动时解析并校验配置，缺少必需项立即报错。适用于新建项目配置体系、从硬编码迁移到环境变量、使用 pydantic-settings 做类型化配置、管理密钥与敏感值、创建 dev/staging/prod 分环境设置、启动时校验配置。
主要能力与核心概念：一是配置外部化，URL、密钥、功能开关等环境相关值均来自环境变量；二是类型化设置，启动时解析校验为类型对象；三是快速失败，启动时校验全部必需配置，缺失即以清晰信息终止；四是合理默认值，本地开发给默认，敏感项必须显式提供。
使用方式：用 pydantic_settings 的 BaseSettings 与 pydantic 的 Field 定义集中设置类，字段用 alias 映射环境变量名，通过 model_config 指定 env_file（如 .env）与编码；模块加载时创建单例实例，用 try/except 捕获 ValidationError 并 sys.exit(1)，应用各处 import 该 settings 而非散布 os.getenv()。无默认值的字段即必填。本地开发用 .env 文件（加入 .gitignore，切勿提交），生产用真实环境变量或密钥管理器。建议按 DB_、REDIS_、AUTH_、FEATURE_ 等前缀命名空间，便于用 env | grep DB_ 调试；容器中可用 secrets_dir 支持挂载密钥。
最佳实践：不硬编码配置；类型化并校验；启动即失败；提供开发默认值；不提交密钥；命名空间化变量；导入单例；README 记录全部变量；尽早校验。
限制：本技能提供全栈开发最佳实践与模式指导，不做非技术业务决策，也不提供完整代码实现，仅给指导；需用户提供具体项目上下文与技术栈信息。更详细的进阶模式见 references/details.md。