VS Code 智能提示 Requests.post 方法中的 kwargs 参数

在使用 Requests 库时，VS Code 可以智能提示 requests.post 方法中的所有 kwargs 参数，包括参数名、类型和默认值。然而，当查看方法源代码时，发现所有 kwargs 参数都被定义为一个字典。那么，VS Code 是如何了解这些参数具体信息的呢？

答案在于 存根文件 (stub file)。存根文件是专门为没有类型信息或类型信息不完整的包提供类型信息标注的文件。这些标注可以随原始包一起分发，也可以单独安装。Pylance（VS Code 中用于 Python 代码分析的语言服务器）为一些常用库提供了自己的存根文件。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

VS Code 提供的智能提示信息就来自这些存根文件。存根文件不会定义 **kwargs，而是将每个具体参数、类型和默认值单独定义。您可以通过 VS Code 中的“Go to type definition”命令查看这些定义文件。

Pylance 会使用这些存根文件中的类型信息为 requests.post 方法中的 kwargs 参数提供智能提示。这使得开发人员可以轻松了解可用的参数选项，从而简化代码编写。