如何将Python Stub文件放入专用目录并让VSCode识别？

当你将Stub文件移到专用stubs目录后，Pylance默认不会自动扫描该目录，可通过以下两种方式配置：

方法一：指定Pylance的Stub文件路径 #

直接在VSCode设置中明确Stub文件的存放目录：

1. 打开VSCode设置（快捷键Ctrl+,）
2. 搜索Python > Analysis: Stub Path
3. 将值设置为stubs目录的相对路径（比如项目根目录下的./stubs）

或者直接编辑.vscode/settings.json文件，添加配置：

{
  "python.analysis.stubPath": "./stubs"
}

方法二：将stubs目录加入分析路径 #

把stubs目录添加到Pylance的额外扫描路径中：
编辑.vscode/settings.json，添加：

{
  "python.analysis.extraPaths": ["./stubs"]
}

注意事项 #

• 确保stubs目录的结构与源文件的包结构一致：比如源文件是根目录下的module.py，那么stubs目录下直接放module.pyi即可；如果是包内的文件（如my_package/module.py），则stubs下需对应创建my_package/module.pyi。
• 配置完成后，重启VSCode或执行Reload Window（快捷键Ctrl+Shift+P后搜索该命令），让配置生效。

内容的提问来源于stack exchange，提问作者The Ancient Coder