Python无真正私有机制，_value和__value均非安全只读；需用@property配合显式raise的setter实现运行时拦截，并辅以Final类型提示增强静态检查。
为什么直接加下划线不能算“安全只读”
很多初学者以为把 _value 或 __value 当作私有属性，外部不主动改就“安全”了——其实完全不是。Python 没有真正的私有机制，_value 只是约定，__value 也只是名称改写（mangling），用 obj._ClassName__value 依然能直接读写。真正需要的是运行时拦截赋值行为。
@property 配合空的 @xxx.setter 会报错
常见错误写法是只定义 @property，却不定义 setter，结果外部尝试赋值时抛出 AttributeError: can't set attribute。这不是 bug，而是预期行为——但要注意：这个报错发生在**运行时**，IDE 和类型检查器（如 mypy）通常无法提前捕获。
正确做法是显式定义一个空 setter 并 raise 错误，让意图更清晰：
class Config:
def __init__(self, host):
self._host = host
<pre class="brush:php;toolbar:false;">@property
def host(self):
return self._host
@host.setter
def host(self, value):
raise AttributeError("host is read-only")
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 这样在 IDE 中 hover 也能看到 setter 被明确定义为不可写
- 如果未来要开放写权限，只需删掉 setter 或重写逻辑，不用动 getter
- 注意：不要写
@host.setter却留空函数体（即pass），那会导致静默失败，反而更危险
需要“只读但可初始化一次”怎么办
有些场景（比如配置类、连接对象）要求属性首次可设、之后锁定。这时不能依赖 @property 单独实现，得结合实例状态控制：
class DatabaseConnection:
def __init__(self, url):
self._url = None
self._url_set = False
self.url = url # 触发自定义 setter
<pre class="brush:php;toolbar:false;">@property
def url(self):
return self._url
@url.setter
def url(self, value):
if self._url_set:
raise AttributeError("url is read-only after initialization")
self._url = value
self._url_set = True
- 关键点是用额外布尔标记（
_url_set）记录是否已初始化，而非靠异常兜底 - 避免在
__init__中直接赋值self._url = url，否则绕过了 setter 的校验逻辑 - 这种模式对多线程不安全；若需并发安全，得加锁或改用
threading.Lock
类型提示和 mypy 对只读 property 的识别
mypy 默认把只有 getter 的 @property 当作只读，但前提是没定义 setter。一旦你写了空 setter 或 raise 的 setter，mypy 就可能误判为“可写”，导致类型检查失效。
解决方法是在类型注解中显式标注为 ReadOnly（需 Python 3.12+）或用 typing.Final 模拟语义（虽不严格等价，但能触发警告）：
from typing import Final
<p>class Config:
def <strong>init</strong>(self, timeout: int):
self._timeout = timeout</p><pre class="brush:php;toolbar:false;">@property
def timeout(self) -> int:
return self._timeout
@timeout.setter
def timeout(self, value: int) -> None:
raise AttributeError("timeout is read-only")
# 提示工具：这个属性应被视为只读
timeout: Final[int] # ← 这行仅用于类型检查，不参与运行时
- 注意
Final是变量级注解，不能直接用在 property 上，所以这里用了“同名遮盖”技巧 - VS Code + Pylance 或 mypy 0.990+ 能据此给出赋值警告
- 别指望它能阻止运行时赋值——这只是增强协作和静态检查
真正难的不是写一个 @property，而是在初始化路径、继承关系、序列化（比如 dict 直接修改）、以及类型工具链之间保持行为一致。哪怕加了 setter 抛错，只要有人调 obj.dict['_host'] = 'new'，保护就形同虚设。所以只读保护本质是“约定 + 运行时提醒 + 工具辅助”，不是银弹。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
