VS Code中Python提示无法导入ClassSample但代码可正常运行，如何解决？

报错原因 #

你在代码中通过sys.path.append('sampleClass/myClass')是运行时动态添加模块搜索路径，Python执行代码时能识别这个路径所以运行正常，但VS Code的Python静态检查工具（Pylance）不会识别代码里动态添加的路径，找不到ClassSample.py的位置，因此出现误报提示。

解决方法 #

• 方法1：配置静态检查额外搜索路径（无需修改现有代码）
  在项目根目录创建.vscode/settings.json文件，添加如下配置：

  {
    "python.analysis.extraPaths": ["./sampleClass/myClass"]
  }
  

  配置完成后按Ctrl+Shift+P调出命令面板，选择「开发者：重新加载窗口」，报错提示就会消失。
• 方法2：调整为标准包导入写法
  给sampleClass、myClass文件夹下各添加一个空的__init__.py文件，将main.py中的代码修改为：

  # 删除sys.path.append这一行
  from sampleClass.myClass.ClassSample import ClassSample
  

  这种写法符合Python包管理规范，不需要额外配置VS Code就能识别。
• 方法3：配置PYTHONPATH环境变量
  将sampleClass/myClass的绝对路径添加到系统或当前虚拟环境的PYTHONPATH环境变量中，重启VS Code后静态检查工具就能读取到对应路径，报错提示会消失。

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