如何让VS Code识别Python导入时的目录结构

方法1：把目标目录转为Python包（最规范） #

这是Python官方推荐的方式，无需额外配置：

• 在你要导入的directory目录下，新建一个空的__init__.py文件（Python会自动将该目录识别为可导入的包）
• 之后直接使用你想要的导入语法：

  from directory.module import MyClass  # 注意：class是Python关键字，不能用作类名
  

• 只要工作区是项目根目录，VS Code和虚拟环境会自动识别这个包，无需其他操作

方法2：用VS Code工作区配置自动添加路径 #

适合不想添加__init__.py的场景，配置一次后同项目自动生效：

• 在项目根目录下新建.vscode文件夹（没有的话直接创建）
• 在.vscode中创建settings.json文件，写入以下内容：

  {
      "python.analysis.extraPaths": [
          "${workspaceFolder}/directory"  // 替换成你实际要导入的目录名
      ]
  }
  

• 重启VS Code或重新加载Python语言服务（按Ctrl+Shift+P输入Python: Reload Window），即可正常导入

方法3：通过虚拟环境的.pth文件永久添加路径 #

适合多个项目复用同一个虚拟环境的情况，配置一次后激活该虚拟环境就自动生效：

• 激活你的虚拟环境，找到虚拟环境的site-packages目录：
  • Windows：虚拟环境目录\Lib\site-packages
  • Mac/Linux：虚拟环境目录/lib/pythonX.X/site-packages（X.X为你的Python版本）
• 在该目录下新建一个后缀为.pth的文件，比如my_project.pth
• 文件内仅需写入项目根目录的绝对路径，例如：

  /Users/yourname/your_project_root  # Mac/Linux
  C:\Users\yourname\your_project_root  # Windows
  

• 保存后，Python和VS Code会自动将该路径加入PYPATH，无需手动设置

注意事项 #

• 禁止使用class作为类名或变量名，这是Python的保留关键字，会引发语法错误
• 确认VS Code左下角显示的Python解释器是当前激活的虚拟环境解释器，若不对可点击切换

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