把 snake_case 名称改为大写并保留下划线:default_page_size → DEFAULT_PAGE_SIZE。在 Python(PEP 8)、Rust、C 和 shell 脚本中,模块级常量都这样书写,而普通变量使用小写的 snake_case。
当原本是局部变量或函数参数的值变成固定设置时,或者需要与现有 snake_case 配置 key 对应的环境变量名时,就可以用它。
文本字符串 中。结果;每条赋值语句右侧的值不会被修改。default_page_size = 20
max_upload_mb = 10
_cache_ttl_seconds = 300DEFAULT_PAGE_SIZE = 20
MAX_UPLOAD_MB = 10
_CACHE_TTL_SECONDS = 300三个名称全部改成了大写。_cache_ttl_seconds 保留了开头的下划线,在 Python 中这表示模块私有的常量。
retry_after_2x → RETRY_AFTER_2X。_cache_ttl_seconds → _CACHE_TTL_SECONDS。timeout)对本工具而言不是 snake_case,仍保持小写。在 Python 模块里,散落在各个函数中的 max_upload_mb = 10 之类的值,可以提到文件顶部写成 MAX_UPLOAD_MB,linter 和读代码的人都会把它当作常量。
YAML 或 TOML 配置使用 database_url 和 log_level 时,对应的环境变量覆盖通常是 DATABASE_URL 和 LOG_LEVEL(例如 pydantic-settings 就是这样映射的)。
timeout 也应该是常量,请自己写成 TIMEOUT。get_user 这样的函数名,也会被改。不会。分隔符完全相同,所以除了你手动编辑过的单词之外,用相反方向的页面可以完全还原。
__all__ 没有变化?snake_case 的匹配规则只允许开头有一个可选的下划线,以两个下划线开头的名称不会被匹配。