一个让后端工程师都惊叹的Python库！(Pydantic-Settings)
大家好，我是茉莉！今天要给大家介绍一个让后端工程师欲罢不能的Python库 - Pydantic-Settings。作为一名Python开发者，配置管理一直是个令人头疼的问题。如何优雅地管理各种环境的配置？如何确保配置的类型安全？Pydantic-Settings完美解决了这些痛点！
什么是Pydantic-Settings？
Pydantic-Settings是Pydantic V2版本中独立出来的一个配置管理库，它继承了Pydantic的所有优点，让配置管理变得优雅而强大。它能帮我们：
自动加载各种格式的配置文件(.env， .yaml， .json等)
类型安全的配置验证
支持不同环境的配置切换
配置值的动态计算
快速入门
首先安装pydantic-settings：
1pip install pydantic-settings
让我们从一个简单的例子开始：
1from pydantic_settings import BaseSettings
2
3class AppSettings(BaseSettings)：
4 app_name：str = “我的应用”
5 port：int = 8000
6 debug：bool = False
7
8settings = AppSettings()
9print(f“应用名称： {settings.app_name}”)
10print(f“端口号： {settings.port}”)
11print(f“调试模式： {settings.debug}”)
这个简单的例子展示了Pydantic-Settings的基本用法。我们定义了一个继承自BaseSettings的类，指定了配置项和它们的类型。
从环境变量加载配置
Pydantic-Settings最强大的特性之一是自动从环境变量加载配置。假设我们有以下环境变量：
1export APP_NAME=“生产环境应用”
2export PORT=80
3export DEBUG=true
同样的代码会自动读取这些环境变量：
1from pydantic_settings import BaseSettings
2
3class AppSettings(BaseSettings)：
4 app_name：str = “我的应用”
5 port：int = 8000
6 debug：bool = False
7
8 class Config：
9 env_file = '.env' # 也可以从.env文件加载
10
11settings = AppSettings()
12# 将输出环境变量中的值，而不是默认值
13print(f“应用名称： {settings.app_name}”) # 输出：生产环境应用
14print(f“端口号： {settings.port}”) # 输出：80
15print(f“调试模式： {settings.debug}”) # 输出：True
嵌套配置
对于复杂的配置，我们可以使用嵌套模型：
1from pydantic_settings import BaseSettings
2from pydantic import BaseModel
3
4class DatabaseSettings(BaseModel)：
5 host：str = “localhost”
6 port：int = 5432
7 user：str = “admin”
8 password：str = “secret”
9
10class AppSettings(BaseSettings)：
11 app_name：str = “我的应用”
12 debug：bool = False
13 db：DatabaseSettings = DatabaseSettings()
14
15settings = AppSettings()
16print(f“数据库地址： {settings.db.host}”)
17print(f“数据库端口： {settings.db.port}”)
动态配置值
有时我们需要基于其他配置值计算某个配置，Pydantic-Settings也支持这种场景：
1from pydantic_settings import BaseSettings
2from pydantic import computed_field
3
4class AppSettings(BaseSettings)：
5 host：str = “localhost”
6 port：int = 8000
7
8 @computed_field
9 @property
10 def api_url(self) -> str：
11 return f“http：//{self.host}：{self.port}”
12
13settings = AppSettings()
14print(f“API地址： {settings.api_url}”) # 输出：http：//localhost：8000
配置验证
Pydantic-Settings继承了Pydantic的强大验证功能：
1from pydantic_settings import BaseSettings
2from pydantic import ValidationError， field_validator
3
4class AppSettings(BaseSettings)：
5 port：int = 8000
6
7 @field_validator('port')
8 def validate_port(cls， v)：
9 if not (1024 <= v <= 65535)：
10 raise ValueError('端口号必须在1024-65535之间')
11 return v
12
13try：
14 settings = AppSettings(port=80)
15except ValidationError as e：
16 print(f“配置错误： {e}”)
小贴士
环境变量命名规则：默认情况下，配置项会自动匹配大写的环境变量名，如
app_name对应APP_NAME配置优先级：环境变量 > .env文件 > 默认值
可以使用
env_prefix设置环境变量前缀，避免命名冲突使用
env_nested_delimiter自定义嵌套配置的分隔符
实践练习
尝试创建一个包含以下配置的应用：
数据库配置（主机、端口、用户名、密码）
Redis配置（主机、端口、数据库索引）
应用配置（调试模式、日志级别、最大连接数）
小伙伴们，今天的Python学习之旅就到这里啦！Pydantic-Settings让配置管理变得如此简单，赶快动手试试吧！有问题随时在评论区问猿小哥哦。祝大家学习愉快，Python学习节节高！
