VSCode中Python调试遇ModuleNotFoundError问题求助

问题概述 #

VSCode调试Python文件时，导入当前目录外的process_variables模块触发ModuleNotFoundError，常规StackOverflow方案无效。

现有配置与路径详情 #

launch.json配置 #

{
    "name": "Python: Current File (Integrated Terminal)",
    "type": "python",
    "request": "launch",
    "console": "integratedTerminal",
    "python": "/Users/{NAME}/projects/toolchain/engine/engine/roles/process/files/myenv/bin/python3",
    "program": "${file}",
    "cwd": "${workspaceRoot}",
    "env": {"PYTHONPATH": "${workspaceFolder}${pathSeparator}${env:PYTHONPATH}"},
    "stopOnEntry": true,
    "justMyCode": false
}

settings.json相关配置 #

...
    "python.analysis.extraPaths": [
        "./engine/engine/scripts",
        "./engine/engine/roles/services/tcpdump/files"
    ],
    "terminal.integrated.env.osx": {
        "PYTHONPATH": "${workspaceFolder}:${env:PYTHONPATH}"
      },
...

文件路径与错误信息 #

• 脚本位置：../projects/engine/engine/scripts
• 目标模块位置：../projects/engine/engine/roles/services/tcpdump/files
• 导入语句：

import process_variables as pv

• 错误：

Exception has occurred: ModuleNotFoundError
No module named 'process_variables'

可行解决方案 #

1. 修正extraPaths的路径写法 #

当前settings.json中extraPaths使用相对路径，VSCode解析时可能出现偏差，替换为基于工作区的绝对路径：

"python.analysis.extraPaths": [
    "${workspaceFolder}/engine/engine/scripts",
    "${workspaceFolder}/engine/engine/roles/services/tcpdump/files"
],

2. 明确指定launch.json的PYTHONPATH #

调试时终端环境可能未正确继承路径，直接在launch.json的env字段中加入模块所在目录：

"env": {
    "PYTHONPATH": "${workspaceFolder}/engine/engine/roles/services/tcpdump/files:${workspaceFolder}/engine/engine/scripts:${env:PYTHONPATH}"
}

3. 添加__init__.py文件 #

在process_variables.py所在目录添加空的__init__.py文件，部分调试场景下需此文件识别为Python模块。

4. 验证虚拟环境的PYTHONPATH #

打开调试终端，执行以下命令查看当前PYTHONPATH：

echo $PYTHONPATH

若输出不包含模块路径，手动设置后重启调试：

export PYTHONPATH="${workspaceFolder}/engine/engine/roles/services/tcpdump/files:${workspaceFolder}/engine/engine/scripts:$PYTHONPATH"

5. 重载VSCode窗口 #

修改配置后，按Cmd+Shift+P（Mac）/Ctrl+Shift+P（Windows）执行Reload Window，确保配置生效。

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