VSCode中Python无法识别同目录模块的问题求助

开发者阿泽

2026-6-22

问题描述

thread_processor和order_processor与main.py处于同一目录，但VSCode无法将其识别为模块，仅在根目录中查找。即使在launch.json中添加如下配置也无法解决问题：

{
    "configurations": [
        {
            "name": "Python",
            "type": "python",
            "stopOnEntry": false,
            "request": "launch",
            "pythonPath": "${config.python.pythonPath}",
            "program": "${file}",
            "cwd": "${workspaceRoot}",
            "debugOptions": [
                "WaitOnAbnormalExit",
                "WaitOnNormalExit",
                "RedirectOutput"
            ],
            "env": {
                "PYTHONPATH": "/src/order_processing_engine"
            }
        }
    ]
}

项目目录结构

解决方案

试试下面几种方法逐步排查：

检查导入语句
确保main.py里的导入写法正确：同目录下直接写import thread_processor；如果用相对导入from . import thread_processor，注意main.py作为脚本运行时需要以模块方式启动（比如python -m your_package.main）。
修正PYTHONPATH配置
你当前配置里的PYTHONPATH是绝对路径，换成相对路径更可靠：
```
"env": {
    "PYTHONPATH": "${workspaceRoot}/src/order_processing_engine"
}
```
或者直接把当前文件所在目录加入PYTHONPATH：
```
"env": {
    "PYTHONPATH": "${fileDirname}"
}
```
添加__init__.py
在main.py所在目录创建一个空的__init__.py文件，标记该目录为Python可识别的模块包。
确认Python解释器
点击VSCode左下角的解释器标识，切换到你实际使用的Python环境，避免因环境不一致导致路径识别错误。
重启VSCode
修改配置后重启编辑器，确保新的路径配置生效。