Visual Studio Code中Python导入错误排查与解决

问题背景 #

在Visual Studio Code中，Python文件间的导入突然出现持续性错误：导入语句下显示黄色下划线，Problems面板提示Import File could not be resolved Pylance(reportMissingImports)。但相同代码在PyCharm中可正常运行，说明问题仅出在VS Code或其相关扩展上。

项目结构为同一目录下的两个Python文件及测试文件：

• file1.py

import file2
file2.my_function()

• file2.py

def my_function():
    print("Hallo aus file2!")

• test_file.py

import file2

def test_my_function():
    assert file2.my_function() == "Hallo aus file2!"

文件路径为C:\Users[username]\import_test\下的对应文件。代码本身可正常运行，但导入被标记为错误，且pytest无法检测到导入（除非直接在文件内测试）。即使重装Python和VS Code并清除所有配置，问题仍存在。

已解决方案 #

创建并使用虚拟环境后，导入功能恢复正常。

已尝试的无效排查步骤 #

• 确保文件及文件夹名称无空格或特殊字符
• 在VS Code中选择正确的Python解释器，包括尝试PyCharm使用的解释器
• 确认Python扩展已安装启用，且仅启用该扩展
• 尝试修改sys.path以包含Python文件所在目录
• 确认所有Python文件均为UTF-8编码
• 完全卸载并重新安装Python和VS Code，清除所有配置文件和设置
• 在settings.json中切换Python语言服务器为Jedi，无效后切回Pylance
• 使用os.getcwd()对比不同环境的当前工作目录，确保一致
• 清除VS Code缓存和扩展数据
• 在目录中添加__init__.py文件
• 尝试相对导入from .file2 import my_function
• 卸载并重新安装pytest

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