VSCode调试Python时导入本地模块报错：找不到'app'模块

先确认项目结构与必要文件 #

确保你的项目根目录是/path/to/my_project，目录结构如下，且app文件夹下存在__init__.py（空文件即可，Python靠它识别目录为可导入模块）：

my_project/
├─ app/
│  ├─ __init__.py
│  ├─ script.py
│  └─ other_script.py  # 注意原报错里的文件名拼写是other_cript，可能是笔误，需确保实际文件名一致
└─ .vscode/
   └─ launch.json

修改VSCode调试配置 #

打开.vscode/launch.json，在调试配置项中添加env字段，把项目根目录加入Python的搜索路径：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Python: Current File",
            "type": "python",
            "request": "launch",
            "program": "${file}",
            "console": "integratedTerminal",
            // 新增这部分配置
            "env": {
                "PYTHONPATH": "${workspaceFolder}"
            }
        }
    ]
}

${workspaceFolder}会自动识别VSCode当前打开的项目根目录，确保Python能找到app模块。

可选：调整导入语句 #

如果script.py和other_script.py在同一目录下，也可以用相对导入：

from .other_script import helper

但相对导入在直接运行脚本时可能出错，配合上面的PYTHONPATH设置用绝对导入（from app.other_script import helper）更稳定。

验证Python解释器 #

确认VSCode底部状态栏选中的Python解释器是你项目使用的环境（虚拟环境或全局环境），避免因解释器路径不一致导致模块搜索失败。

内容的提问来源于stack exchange，提问作者Arseniy-II