VS Code配置PYTHONPATH后仍无法导入自定义模块求助

问题核心 #

你已配置launch.json和settings.json但仍出现ModuleNotFoundError，原因可能是PYTHONPATH路径配置逻辑、VS Code工作区识别或解释器环境不一致导致的。以下是无需修改代码、不依赖命令行的解决方案：

解决方案步骤 #

1. 确认VS Code工作区根目录 #

必须打开项目最外层目录（包含.vscode、house_mgt、repos的文件夹）。若打开的是子目录，${workspaceFolder}会指向错误路径，所有基于该变量的配置都会失效。

2. 修正launch.json的PYTHONPATH配置 #

运行时的模块搜索路径由launch.json的env.PYTHONPATH决定，有两种配置方式适配你的需求：

方式一：保留原导入语句from house_functions import ...

将PYTHONPATH直接指向house_functions.py所在的目录：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Module",
            "type": "python",
            "request": "launch",
            "module": "house_mgt.main",
            "justMyCode": true,
            "env": {
                "PYTHONPATH": "${workspaceFolder}/repos/functions"
            }
        }
    ]
}

方式二：按项目结构规范导入（更推荐）

将整个项目根目录加入PYTHONPATH，这样可以按目录层级导入模块：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Module",
            "type": "python",
            "request": "launch",
            "module": "house_mgt.main",
            "justMyCode": true,
            "env": {
                "PYTHONPATH": "${workspaceFolder}"
            }
        }
    ]
}

此时main.py的导入语句需修改为：

from repos.functions.house_functions import create_data_preprocessor

3. 同步settings.json的分析路径 #

settings.json中的python.analysis.extraPaths仅影响代码提示，需与运行路径保持一致，避免编辑器报错：

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

4. 验证Python解释器一致性 #

点击VS Code底部状态栏的Python解释器图标，确认选中的解释器与PyCharm中使用的完全相同（包括虚拟环境、系统Python版本）。不同解释器的环境变量独立，会导致路径识别差异。

5. 重启Python语言服务 #

按下Cmd+Shift+P（Mac）或Ctrl+Shift+P（Windows/Linux），执行Python: Restart Language Server，让新配置立即生效。

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