如何在VSCode中导入.pyi存根文件？解决模块找不到问题

1. 把stubshome变成合法Python包 #

在stubshome目录里新建一个空的__init__.py文件——Python需要这个文件来识别该目录为可导入的模块包，哪怕是空文件也能满足要求，这是解决导入问题的基础步骤。

2. 确保Python能找到你的包 #

• 检查VSCode工作目录：确认当前打开的工作区是包含Hellomath.py和stubshome的根目录。如果不是，右键点击根目录选择「Set as Workspace Folder」。
• 手动添加路径到Python搜索列表：如果工作目录设置无误仍报错，在Hellomath.py开头添加以下代码，强制将项目根目录加入模块搜索路径：

  import sys
  from pathlib import Path
  sys.path.append(str(Path(__file__).parent))
  

3. 明确存根文件的正确用法 #

.pyi存根文件是给类型检查工具（比如Pylance、mypy）提供类型提示的，它本身不能作为可执行模块被导入。你需要根据需求调整：

• 如果是给stubshome/Hellomath.py这个实际代码文件添加类型提示，只需将Hellomath.pyi放在同一目录下，无需手动导入存根文件，类型检查器会自动关联两者。
• 如果是想用存根文件定义的类型，需确保对应的实际模块存在，导入时指向实际模块（比如import stubshome.Hellomath导入的是stubshome/Hellomath.py，而非.pyi文件）。

4. 配置VSCode的类型检查工具 #

• 打开VSCode设置，将python.analysis.typeCheckingMode设为basic或strict，让Pylance能正确识别存根文件。
• 也可以在项目根目录创建pyrightconfig.json文件，指定存根路径：

  {
    "stubPath": "./stubshome"
  }
  

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