Python没有真正的内部类，嵌套类仅是语法嵌套，不自动持有外部实例引用，无法访问外部实例变量和方法，需显式传参，且存在命名冲突、序列化失败、类型检查弱等限制。
Python里没有真正的“内部类”，所谓Inner Class只是语法上嵌套的类定义，它不自动持有对外部类实例的引用，也不受作用域绑定保护——这是它不常用、也容易误用的根本原因。
Python嵌套类不自动绑定外部实例
Java或C++的inner class能直接访问外部类的私有字段，靠的是编译器注入this$0隐式引用。Python不做这件事：嵌套类Inner定义在Outer内部，但Inner()创建时完全独立，既看不到self，也无法读取Outer的实例属性。
- 常见错误现象：
AttributeError: 'Inner' object has no attribute 'name'，以为Inner能像Java一样直接用self.name - 必须显式传参：
inner = self.Inner(self)，否则Inner就是个普通独立类 - 参数差异：
Inner构造函数第一个参数不是self，而是你手动传入的outer_instance，否则它根本不知道外面是谁
嵌套类无法访问外部类的实例变量和方法
Python嵌套类的作用域只在定义时生效，运行时它和模块级类没区别。它不能通过词法作用域访问Outer的__init__中定义的self.xxx，也不能调用self.outer_method()。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
- 使用场景受限：不适合做“依赖外部状态”的辅助逻辑，比如解析器里的子状态机、GUI组件里的事件处理器
- 容易踩的坑：写完
class Outer: class Inner: def go(self): print(self.outer_data)，运行就报NameError - 替代方案更自然：用闭包封装状态，或把逻辑抽成独立函数+参数传递，反而更清晰、更易测试
嵌套类的命名空间隔离是假的
虽然Outer.Inner看起来像命名空间嵌套，但它在导入、序列化、反射时都暴露为全局可访问路径——module.Outer.Inner和module.Inner（如果顶层也定义了同名类）可能冲突，且pickle序列化会失败，除非Inner在模块顶层可导入。
立即学习“Python免费学习笔记（深入）”；
- 性能影响：嵌套类在每次
Outer加载时重新定义，若Outer被高频实例化，会重复执行类定义字节码 - 兼容性问题：某些静态分析工具（如mypy）对嵌套类类型推导支持弱，
typing.Self等新特性也不适用 - 真实限制：你不能用
from module import Outer然后指望Outer.Inner能被IDE正确补全或被type checker识别为关联类型
真正关键的一点是：Python不提供inner class，不是缺陷，而是设计选择。当你发现非得靠嵌套类来“隐藏”某个辅助结构时，大概率说明这个结构本该拆出去——要么是独立工具函数，要么是带明确接口的策略类，要么是@dataclass组合体。强行嵌套，只会让调试变难、mock变重、重构变脆。
