Python 3.13中threading.Lock的acquire与acquire_lock差异咨询

• 未文档化方法的本质：acquire_lock、release_lock、locked_lock是CPython内部实现的底层接口，属于未对外公开的私有逻辑，标注undocumented就是明确提示开发者：这些方法不应该在业务代码中直接使用，仅用于解释器内部或扩展模块的底层交互。

• 与标准方法的关联：标准的acquire()和release()方法其实是对这些底层接口的封装。比如acquire()会处理blocking、timeout等参数逻辑，最终调用acquire_lock()完成实际的锁获取操作；release()则会先做合法性校验（比如当前线程是否持有锁），再调用release_lock()释放锁。

• 直接调用的差异：

  • lock.acquire_lock()没有参数处理逻辑，仅支持阻塞式获取锁，等价于lock.acquire(blocking=True, timeout=-1)，但无法设置非阻塞模式或超时时间。
  • lock.acquire()是面向开发者的正式API，提供了灵活的参数选项，能满足不同场景的锁使用需求。

• 关于名称变更的疑问：这些底层接口不会取代标准的acquire/release方法，也不是未来的名称变更方案。它们从设计之初就是内部实现细节，标准API会保持稳定，不会轻易变更名称或替换为这些未文档化方法。

参考代码中相关未文档化方法标注示例：

# undocumented methods
def acquire_lock(self):
    """Acquire lock without checking args (internal use only)"""
    ...
def release_lock(self):
    """Release lock without checking args (internal use only)"""
    ...
def locked_lock(self):
    """Return True if lock is held (internal use only)"""
    ...

内容的提问来源于stack exchange，提问作者leolion3