0

0

Python 常量集中管理的实现方式

冷炫風刃

冷炫風刃

发布时间:2026-02-16 15:33:10

|

232人浏览过

|

来源于php中文网

原创

模块顶层定义最安全,避免用class封装常量;应显式导入而非from ... import *;环境相关常量需通过os.getenv读取;类型提示须用final或literal增强检查。

python 常量集中管理的实现方式

常量该不该放进 class 里? Python 没有语言级常量,所谓“常量”只是约定(全大写 + 不改)。但放哪儿最不踩坑?直接塞模块顶层最安全。用 class 封装看似整洁,实则容易误用:类属性会被实例意外修改(尤其用了可变对象),继承时还可能被子类覆盖。更麻烦的是 IDE 和类型检查器(如 mypy)对 class 内常量的推导支持弱,typing.LiteralFinal 很难生效。
  • 模块级定义:直接在 constants.py 里写 MAX_RETRY = 3API_TIMEOUT = 30.0
  • 避免 class Constants: 这种包装,除非你明确需要命名空间隔离(比如多个业务域常量易重名)
  • 如果真要用类,必须加 <strong>slots</strong> = () 并配合 typing.Final(仅 Python 3.8+),否则形同虚设

from constants import * 为什么危险? 这种导入方式会让常量“隐身”——你没法一眼看出某个变量是哪来的,重构时也难以定位引用。更重要的是,它会污染当前命名空间,和本地变量、函数名冲突后,错误往往延迟到运行时才暴露(比如覆盖了内置 idlist)。
  • 始终用显式导入:from constants import MAX_RETRY, API_TIMEOUT
  • 或者只导入模块本身:import constants,然后用 constants.MAX_RETRY
  • 如果常量太多,考虑按用途拆分文件,比如 http_constants.pydb_constants.py

环境相关常量怎么处理? 硬编码 DEV_URL = "https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774"PROD_URL = "https://api.example.com" 是反模式。运行时该用哪个,取决于部署环境,不是开发时能定死的。
  • 把环境变量作为唯一可信源:os.getenv("API_BASE_URL", "<a href="https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774">https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774</a>")
  • constants.py 里封装读取逻辑,而不是存字符串值:
    import os
    API_BASE_URL = os.getenv("API_BASE_URL", "https://www.php.cn/link/fcbb3a1c04ec11f1506563c26ca63774")
    JWT_ALGORITHM = os.getenv("JWT_ALGORITHM", "HS256")
    
  • 切忌在常量模块里做复杂逻辑(如条件判断选 URL),那已经不属于“常量”范畴了

类型提示怎么加才有效? 光写 DB_PORT = 5432,mypy 默认当 int 看,但实际它永远是这个值。用 LiteralFinal 才能让类型系统真正帮你卡住错误。
  • 基础值用 FinalMAX_RETRY: Final[int] = 3
  • 枚举类常量优先用 Enum,别用字符串元组;如果非用字符串,上 LiteralLOG_LEVEL: Final[Literal["DEBUG", "INFO", "ERROR"]] = "INFO"
  • 注意 Final 不阻止运行时修改(Python 无强制),但它让 mypy 报错:MAX_RETRY = 5 会触发 error: Cannot assign to final attribute

常量看着简单,但一旦混进环境逻辑、类型模糊、导入随意,后面查问题的人会花三倍时间还原上下文。最稳妥的做法,其实是少而明确:一个文件、全大写、不带逻辑、类型标清、环境靠外置。

极限网络办公Office Automation
极限网络办公Office Automation

专为中小型企业定制的网络办公软件,富有竞争力的十大特性: 1、独创 web服务器、数据库和应用程序全部自动傻瓜安装,建立企业信息中枢 只需3分钟。 2、客户机无需安装专用软件,使用浏览器即可实现全球办公。 3、集成Internet邮件管理组件,提供web方式的远程邮件服务。 4、集成语音会议组件,节省长途话费开支。 5、集成手机短信组件,重要信息可直接发送到员工手机。 6、集成网络硬

下载

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1553

2023.10.24

scripterror怎么解决
scripterror怎么解决

scripterror的解决办法有检查语法、文件路径、检查网络连接、浏览器兼容性、使用try-catch语句、使用开发者工具进行调试、更新浏览器和JavaScript库或寻求专业帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

351

2023.10.18

500error怎么解决
500error怎么解决

500error的解决办法有检查服务器日志、检查代码、检查服务器配置、更新软件版本、重新启动服务、调试代码和寻求帮助等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

339

2023.10.25

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

552

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

216

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1553

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

640

2023.11.24

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

925

2024.03.22

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

283

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.3万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号