VSCode中pandas.options自动补全的实现原理探究

pandas 能实现pd.options.display.max_rows这类动态属性的自动补全，核心原因是它为动态生成的options结构提供了静态类型存根文件（.pyi），让VSCode的Pylance语言服务器可以通过静态分析识别这些属性。

具体细节如下：

• pandas的options系统确实是运行时通过getattr动态注册、动态创建对象实现的，这类逻辑本身无法被静态分析工具直接识别。但pandas官方额外编写了对应的类型存根文件，在存根里提前定义了pd.options、pd.options.display等层级的所有属性（包括max_rows这类选项），并标注了它们的类型。
• 你在pandas仓库中将全局导入改为相对导入后自动补全失效，正好印证了这一点：相对导入会让Pylance无法关联到对应的全局类型存根，自然无法提供提示。
• 你自定义的DictWrapper类没有对应的类型存根文件，静态分析工具无法预知动态生成的属性，所以无法触发自动补全。如果要实现类似效果，需要为你的类编写对应的.pyi存根文件，在其中声明所有需要被自动补全的属性和类型。

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