VSCode中Python项目跨目录模块导入与虚拟环境兼容问题咨询

不用调整项目结构，这几个简便方法就能搞定：

方法1：VSCode配置PYTHONPATH #

在项目根目录下新建.vscode/settings.json文件，写入以下内容：

{
    "python.analysis.extraPaths": ["${workspaceFolder}"]
}

这样VSCode的代码提示能识别config模块，同时只要你在VSCode终端激活了虚拟环境（.venv）运行program.py，Python会自动把项目根目录加入搜索路径，既能用numpy这类虚拟环境包，也能导入config。

方法2：在program.py中临时添加路径 #

在program.py的最开头加几行代码，把项目根目录加到Python的模块搜索路径里：

import sys
from pathlib import Path

# 获取项目根目录（src的父目录）并加入sys.path
sys.path.append(str(Path(__file__).parent.parent))

# 现在就能正常导入了
import numpy
import config

不用担心影响虚拟环境包：虚拟环境的site-packages目录在sys.path里的优先级比你追加的路径高，导入时会先找虚拟环境里的包，完全不会冲突。

方法3：把项目转为可安装包（适合长期维护的项目） #

在项目根目录下创建pyproject.toml文件，内容示例：

[build-system]
requires = ["setuptools>=61.0"]
build-backend = "setuptools.build_meta"

[project]
name = "your-project-name"
version = "0.1.0"
packages = ["config", "src"]

然后在激活虚拟环境的终端里运行：

pip install -e .

这样项目会以可编辑模式安装到虚拟环境里，不管你从哪个路径运行program.py，都能直接导入config和虚拟环境的包，是最规范的长期解决方案。

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