0

0

typing.Final 如何在类型检查中强制常量不可修改

舞夢輝影

舞夢輝影

发布时间:2026-01-25 20:05:35

|

324人浏览过

|

来源于php中文网

原创

typing.Final 不能阻止运行时赋值,仅在类型检查阶段生效;模块级 Final 变量禁止任何赋值,类中 Final 属性允许在 init 中初始化一次。

typing.final 如何在类型检查中强制常量不可修改

typing.Final 能否阻止运行时赋值?

typing.Final 完全不干预运行时行为,它只在类型检查阶段(如 mypy、pyright、PyCharm 的类型分析)起作用。你写 CONST: Final[int] = 42,然后执行 CONST = 100,Python 解释器照常运行,不会报错也不会警告——但 mypy 会报 error: Cannot assign to final attribute "CONST"

必须显式标注类型才能触发检查

仅写 CONST = 42 再加 Final 注解是无效的。类型检查器需要明确的类型标注,且 Final 必须出现在变量声明语句的类型注解位置:

  • ✅ 正确:CONST: Final[int] = 42
  • ✅ 正确(模块级常量推荐):CONST: Final = 42(此时类型由值推导为 Final[int]
  • ❌ 无效:CONST = 42 # type: Final[int](旧式注释不被 mypy 当作 Final 处理)
  • ❌ 无效:CONST: int 后再用 Final 包裹值(CONST: int = Final[42] 不合法)

Final 变量在类中和模块中的行为差异

模块级 Final 变量被设计为“真正常量”,而类属性上的 Final 允许在 __init__ 中赋值一次(类似“一次赋值”语义),这点容易误判:

AIBox 一站式AI创作平台
AIBox 一站式AI创作平台

AIBox365一站式AI创作平台,支持ChatGPT、GPT4、Claue3、Gemini、Midjourney等国内外大模型

下载
  • 模块级:API_URL: Final[str] = "https://api.example.com" → mypy 禁止任何后续赋值
  • 类属性:class Client: timeout: Final[int]; def __init__(self): self.timeout = 30 → 合法;但 client.timeout = 60 会在实例上调用时报错
  • 注意:类中未在 __init__ 赋值的 Final 实例属性,mypy 会报 Final instance attribute not initialized

常见误用与绕过检查的风险点

开发者有时试图用动态方式绕过 Final 限制,比如 globals()["CONST"] = 999setattr(sys.modules[__name__], "CONST", 999)。这些操作:

  • ✅ 运行时确实能改掉值(因为 Python 没有真正的常量机制)
  • ❌ 但会破坏类型系统的可信度,导致其他开发者或工具误以为该值稳定
  • ⚠️ 更隐蔽的问题:如果该 Final 值被用于 Literal 类型推导(如 def f(x: Literal[CONST]) -> None: ...),绕过赋值会让类型推导失效甚至出错

真正想“强制不可变”,得靠运行时手段(如 __slots__ + 自定义 __setattr__),但那已超出 typing.Final 的职责范围——它只是给类型检查器看的契约标签,不是锁。

热门AI工具

更多
DeepSeek
DeepSeek

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

豆包大模型
豆包大模型

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

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

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

文心一言
文心一言

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

讯飞写作
讯飞写作

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

即梦AI
即梦AI

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

ChatGPT
ChatGPT

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

相关专题

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

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

1570

2023.10.24

scripterror怎么解决
scripterror怎么解决

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

492

2023.10.18

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

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

382

2023.10.25

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

564

2023.09.20

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1051

2023.08.02

int占多少字节
int占多少字节

int占4个字节,意味着一个int变量可以存储范围在-2,147,483,648到2,147,483,647之间的整数值,在某些情况下也可能是2个字节或8个字节,int是一种常用的数据类型,用于表示整数,需要根据具体情况选择合适的数据类型,以确保程序的正确性和性能。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

614

2024.08.29

c++怎么把double转成int
c++怎么把double转成int

本专题整合了 c++ double相关教程,阅读专题下面的文章了解更多详细内容。

335

2025.08.29

C++中int的含义
C++中int的含义

本专题整合了C++中int相关内容,阅读专题下面的文章了解更多详细内容。

235

2025.08.29

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

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

精品课程

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

共4课时 | 22.5万人学习

Django 教程
Django 教程

共28课时 | 5万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.9万人学习

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

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